# Welcome Aboard!

{% hint style="info" %}
**What is DIGIT?** - **DIGIT** is an open-source platform for service delivery and governance. It enables ease of access to services for citizens, ease of coordination for employees & vendors, ease of administration for administrators and ease of policy-making for policymakers & researchers. With its common services and shared data registries, DIGIT has been leveraged in multiple domains.

**Developers & engineers** - [Click here](/welcome-aboard/digit-platform) to learn more about the platform architecture, specifications, microservices (common services and reusable registries), and get started with DIGIT.

**Product managers & solution architects** - [Click here](/welcome-aboard/products-and-solutions) to find more details on our product suites.

**Programme managers & implementation partners** - Open the **Programmes** tab below to explore our programmes.
{% endhint %}

{% tabs %}
{% tab title="Platforms" %}

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><a href="https://docs.digit.org/local-governance"><mark style="color:blue;"><strong>Local Governance</strong></mark></a></td><td><p><a href="https://docs.digit.org/local-governance/urban/release-notes">Release Notes:</a> Find out what's new in Local Governance - release features and enhancements</p><p><a href="https://docs.digit.org/local-governance/technology/architecture">Architecture:</a> Understand the urban platform architecture<br></p><p><a href="https://specs.digit.org/digit-urban-service-specs">Specifications:</a> Access the urban specifications - data models and APIs</p><p><a href="https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack">Products:</a> Know more about the urban applications built on the DIGIT platform</p></td><td></td></tr><tr><td><a href="https://docs.digit.org/sanitation"><mark style="color:blue;"><strong>Water &#x26; Sanitation</strong></mark></a></td><td><p><a href="https://docs.digit.org/sanitation/water-sanitation/release-notes">Release Notes:</a> Find out what's new in Water &#x26; Sanitation - release features and enhancements</p><p><a href="https://docs.digit.org/sanitation/technology/architecture">Architecture:</a> Understand the sanitation platform architecture</p><p><a href="https://specs.digit.org/digit-sanitation-service-specs">Specifications:</a> Access sanitation specifications - data models and APIs</p><p><a href="https://docs.digit.org/sanitation/water-sanitation-product-suite/waste-management-system">Products:</a> Know more about the sanitation applications built on the DIGIT platform</p></td><td></td></tr><tr><td><a href="https://docs.digit.org/public-finance"><mark style="color:blue;"><strong>Public Finance Management (PFM)</strong></mark></a></td><td><p><a href="https://docs.digit.org/public-finance/introducing-public-finance-management-pfm/release-notes">Release Notes:</a> Find out what's new in Public Finance - release features and enhancements</p><p><a href="https://docs.digit.org/public-finance/technology/architecture">Architecture:</a> Understand the PFM platform architecture</p><p><a href="https://specs.digit.org/digit-public-finance-management-service-specs">Specifications:</a> Access PFM specifications - data models and APIs</p><p><a href="https://docs.digit.org/public-finance/exemplars/pfm-implementations">Reference implementations</a><a href="https://pfm.digit.org/exemplar">:</a> Learn more about the exemplars built using public finance</p></td><td></td></tr><tr><td><a href="https://docs.digit.org/health"><mark style="color:blue;"><strong>Public Health</strong></mark></a></td><td><p><a href="https://docs.digit.org/health/introducing-health/release-notes">Release Notes: </a>Find out what's new in Public Health - release features and enhancements</p><p><a href="https://docs.digit.org/health/technology/architecture">Architecture:</a> Understand the Health platform architecture</p><p><a href="https://specs.digit.org/digit-health-service-specs">Specifications:</a></p><p>Access Health specifications - data models and APIs</p><p><a href="https://docs.digit.org/health/hcm-product-suite/health-products">Products:</a> Know more about the Health applications built on the DIGIT platform</p><p><a href="https://docs.digit.org/health/product-roadmap">Roadmap:</a> Explore the Public Health roadmap</p></td><td></td></tr></tbody></table>
{% endtab %}

{% tab title="Products" %}
Click on the cards below to explore the products and solutions that have been built on top of the DIGIT platform:

* [Public Health](/welcome-aboard/products-and-solutions/public-health): Designed to work across countries at varying levels of capacity and complexity, it is an open-source Digital Public Good that aims to expand capabilities in public health.
* [Public Finance](/welcome-aboard/products-and-solutions/public-finance): It is an open-source fiscal information exchange platform that enables connected applications to exchange standardised fiscal events
* [Water & Sanitation](/welcome-aboard/products-and-solutions/water-and-sanitation): It is an open-source web and mobile-enabled platform designed to digitise operations in the waste management value chain, from collection to treatment.
* [Local Governance](/welcome-aboard/products-and-solutions/local-governance): Set up as a public good, it is a set of open APIs, services, and reference implementations that allows government entities, businesses, startups, and civil society to use a unique digital Infrastructure and build solutions for urban India at a large scale.
  {% endtab %}

{% tab title="Programmes" %}
Programmes refer to the various implementations of our applications at the state level, Urban Local Bodies level, or any institution level. Programmes are customised per the stakeholder requirements and exemplify multiple use cases met by DIGIT applications.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><h3>Local Governance Programmes</h3></td><td><a href="https://niua.in/cdg/UPYOG">NIUA</a> - The UPYOG programme, using the DIGIT platform and the Urban reference applications, assists municipal bodies across India to improve service delivery mechanisms, achieve better information management &#x26; transparency, and ensure citizen involvement in participative governance.</td><td></td></tr><tr><td><h3>Public Finance Programmes</h3></td><td><a href="https://mgramseva.digit.org/">mGramSeva</a> - It is an application that has been developed as part of the iFIX <a href="https://mgramseva.digit.org/">Exemplar</a> in Punjab. It enables rural local bodies to manage revenue and expenditures related to water supply projects using a mobile app.</td><td><a href="https://works.digit.org/programs/muktasoft">MuktaSoft </a>- Mukhyamantri Karma Tatpara Abhiyan Yojana ( MUKTA Yojana) is an Odisha government-launched scheme aimed towards employing the urban poor which also leads to improving the employment rate of the state.</td></tr><tr><td><h3>Public Health Programmes</h3></td><td><a href="https://health.digit.org/programme">Mozambique</a>: The Health Campaign Management Platform (HCM) is an extensive digital infrastructure that aims to provide a digital system that will streamline health campaign activities in Mozambique. It will enable field workers, supervisors, district officers, and other stakeholders to collect, analyse and monitor data accurately, from registration to service delivery.</td><td></td></tr><tr><td><h3>Water &#x26; Sanitation Programmes</h3></td><td><a href="https://sanitation.digit.org/programme">Sujog</a>: The Government of Odisha (GoO) has initiated a programme called "SUJOG - Sustainable Urban Services in a Jiffy by Odisha Government" through the Housing and Urban Development Department (H&#x26;UDD). The primary objective of this programme is to implement e-governance services across the Urban Local Bodies (ULBs) in the state.</td><td></td></tr></tbody></table>
{% endtab %}

{% tab title="Guides" %}

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><a href="https://design.digit.org/ui-docs/"><strong>Design System Guide</strong></a></td><td><strong>-</strong> DIGIT design standards and principles</td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/guides/data-setup-guide"><strong>Data Setup Guide</strong></a></td><td>- Seeding data in DIGIT post installation</td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/guides/design-guide"><strong>Design Guide</strong></a></td><td>- Platform design process</td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/guides/installation-guide"><strong>Installation Guide</strong></a></td><td>- Resources and steps to Install DIGIT</td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/guides/operations-guide"><strong>Operations Guide</strong></a></td><td>- Steps to monitor and operate the DIGIT platform and services</td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/guides/developer-guide"><strong>Developer Guide</strong></a></td><td>- Steps for developing and deploying the DIGIT platform (backend &#x26; frontend)</td><td></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

**More About DIGIT**

* [Principles](https://docs.digit.org/platform/platform/principles)
* [Value Proposition](https://docs.digit.org/platform/platform/digit-value-proposition)
* [Academy](https://academy.digit.org/)
* [Sandbox](https://docs.digit.org/platform/accelerators/sandbox)

<details>

<summary>Additional Help Topics</summary>

* [**Checklists**](https://docs.digit.org/platform/platform/checklists) - API, application security, performance & deployment checklists
*

</details>


# DIGIT Platform

DIGIT is a suite of platforms, products and tools to enable government agencies to drive digital transformation at speed and scale to transform citizen service delivery. DIGIT platform provides a set of reusable common services and registries that provide a scalable, secure, and reliable base on which to build highly configurable products for service delivery and governance.  Some of these common services include authentication, authorisation, payment, notifications, demand, bills, etc.&#x20;

DIGIT is built using platform-based principles that enable seamless data sharing and functionality through well-defined building blocks. The building blocks can be integrated into higher-level services and recomposed further to deliver unified data and experiences. DIGIT product suites comprise several applications that can be used to deliver urban, health, and sanitation services.

## Important Links

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><a href="https://docs.digit.org/platform/platform/architecture"><strong>Architecture:</strong> </a>Explore DIGIT open-source platform architecture.</td><td><p></p><p><a href="https://docs.digit.org/platform/platform/architecture/service-architecture"><strong>Service architecture</strong></a> <strong>-</strong> Microservice reusable building blocks architecture</p><p><a href="https://docs.digit.org/platform/platform/architecture/infrastructure-architecture"><strong>Infrastructure architecture</strong></a> <strong>-</strong> Infrastructure resources required to deploy DIGIT</p><p><a href="https://docs.digit.org/platform/platform/architecture/technology-architecture"><strong>Technology architecture</strong></a> - Technology tools used to develop and deploy DIGIT</p><p><a href="https://docs.digit.org/platform/platform/architecture/deployment-architecture"><strong>Deployment architecture</strong></a> <strong>-</strong> Architecture design for deployment framework and approach</p></td><td></td></tr><tr><td><p><a href="https://specs.digit.org/"><strong>Specifications:</strong>  </a>Learn how to co-create using our platform specifications.</p><p>DIGIT is a specification-driven open-source technology platform that leverages the capabilities of microservice design to promote responsive and agile solutions.</p></td><td><p><a href="https://specs.digit.org/common-service-specs"><strong>Common Service Specifications</strong></a> <strong>-</strong> Specifications for commonly used services available on the platform. </p><p></p><p><a href="https://specs.digit.org/domain-service-specs"><strong>Domain Service Specifications</strong> </a><strong>-</strong> Domain-centric specifications that extend the functional capabilities of the platform.</p></td><td></td></tr><tr><td><p><a href="https://docs.digit.org/platform/guides/installation-guide"><strong>Getting Started:</strong> </a>Access resources required to get you started with the DIGIT platform.</p><p>Click on the links below to get started with the installation and deployment of the DIGIT platform.</p></td><td><p><a href="https://docs.digit.org/platform/accelerators/sandbox"><strong>Sandbox</strong></a> <strong>-</strong> The Sandbox environment allows users to easily build a service on DIGIT</p><p><a href="https://docs.digit.org/platform/guides/installation-guide/digit-deployment"><strong>DIGIT Deployment</strong></a> <strong>-</strong> High-level overview of DIGIT deployment</p></td><td></td></tr><tr><td><a href="https://docs.digit.org/platform/platform/core-services"><strong>Core Services</strong></a> - Access the building blocks or microservices that add and extend the platform capabilities.</td><td></td><td></td></tr></tbody></table>


# Products and Solutions

Browse through our support docs for DIGIT reference applications

Click on the product cards below to access related docs.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><a href="/spaces/X5JaKUo3lbPNpS3TKJiJ/pages/eYjTehR5L584VTHXPMF1"><strong>Public Health</strong></a></td><td></td><td></td></tr><tr><td><a href="/spaces/X5JaKUo3lbPNpS3TKJiJ/pages/40pUS7H4n24x4H8dQbfk"><strong>Public Finance</strong></a></td><td></td><td></td></tr><tr><td><a href="/spaces/X5JaKUo3lbPNpS3TKJiJ/pages/5bBIpuyACK3BltP7jm9o"><strong>Water &#x26; Sanitation</strong></a></td><td></td><td></td></tr><tr><td><a href="/spaces/X5JaKUo3lbPNpS3TKJiJ/pages/ZltcEMFGlqzRMn2NQaMY"><strong>Local Governance</strong></a></td><td></td><td></td></tr></tbody></table>


# Public Health

The Public Health solution is built as an open-source Digital Public Good to expand capabilities in public health. It is being designed to work across countries at varying levels of capacity and complexity. The solution reimagines the public health space as a set of horizontal building blocks, such as shared registries, and services, accessible through well-defined open APIs, which can be leveraged by multiple countries and disease programmes.

The Public Health solution offers an end-to-end flexible, open, configurable, and reusable platform to plan, manage and run any public health programme such as health campaigns so there is detailed and timely monitoring and evaluation to review coverage, target achievement and identification of gaps for their distribution.

Explore the Public Health reference applications below:

* [Health Campaign Management](/welcome-aboard/products-and-solutions/public-health/health-campaign-management-hcm)


# Health Campaign Management (HCM)

The mission is to build a digital infrastructure that enables decision-makers and programme managers to streamline campaign planning, manage workflows and monitor service delivery in real-time to aid data-driven decision-making.

A Health Campaign Management Platform will offer a single interface for managing all components in a campaign lifecycle, enable reuse of assets across campaigns, reduce fragmentation by supporting multiple diseases, and support data interoperability with other health intervention areas.

Click on the links below to learn more about our products:

* [Frontline Worker's App](/welcome-aboard/products-and-solutions/public-health/health-campaign-management-hcm/frontline-workers-app)
* [Campaign Management Dashboard](/welcome-aboard/products-and-solutions/public-health/health-campaign-management-hcm/campaign-management-dashboard)


# Frontline Worker's App

This is an easy-to-use app with offline capability, guided user flows and analytics support.

* [x] [Functional Scope](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/features) - Application features, functions, and capabilities
* [x] [User Manual](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual)
  * [Language Selection](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual/support-functions/language-selection)
  * [Login](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual/support-functions/login)
  * [Forgot Password](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual/support-functions/forgot-password)
  * [Project Selection](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual/support-functions/project-selection)
  * [Beneficiary Registration and Delivery](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/hcm-user-manual/campaign-types/multi-round-campaigns/registration-and-delivery)
  * [Stock Management](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/inventory-management)
  * [Checklist](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/enumeration-checklist)
* [x] [API Specifications](https://docs.digit.org/health/design/architecture/low-level-design)
* [x] [Service Configuration](https://docs.digit.org/health/deploy/configuration)
* [x] [UI Configuration](https://docs.digit.org/health/deploy/configuration/hcm-ui-configuration)


# Campaign Management Dashboard

The dashboard offers multiple features that deliver a comprehensive view of the campaign&#x20;

* [x] [User Manual](https://docs.digit.org/health/access/public-health-product-suite/campaign-management-dashboard/user-manual) - Explore the campaign management user guide
* [x] [Integrated Cross-Campaign Dashboard (ICCD)](https://docs.digit.org/health/access/public-health-product-suite/campaign-management-dashboard/integrated-cross-campaign-dashboard-iccdhttps://docs.digit.org/health/access/public-health-product-suite/campaign-management-dashboard/integrated-cross-campaign-dashboard-iccd) - Application features, functions, and capabilities
* [x] [Service Configuration](https://docs.digit.org/health/deploy/configuration/hcm-dashboard-configurations) - Learn how to configure the dashboard


# Public Finance

Public Finance Management, or iFIX, is an open-source fiscal information exchange solution. The application enables connected modules to exchange standardised fiscal events. Example: Demand, Receipts, Bills, and Payments. The fiscal event consists of attributes explaining the details of why, who, what, where and when it happened.

Explore the Public Finance Management reference applications below:

* [mGramSeva](/welcome-aboard/products-and-solutions/public-finance/revenue-and-expenditure-management-mgramseva)
* [Works Management & Smart Payments](/welcome-aboard/products-and-solutions/public-finance/works-management-and-smart-payments)


# Revenue & Expenditure Management (mGramSeva)

* [x] [Functional Scope](https://docs.digit.org/mgramseva) - Application features, functions, and capabilities
* [x] [User Manual ](https://docs.digit.org/mgramseva/introducing-mgramseva/product-docs/user-docs/user-manual)- Illustrative guide for app users
* [x] [Configure mGramSeva](https://docs.digit.org/mgramseva/introducing-mgramseva/platform/configure-mgramseva)


# Fiscal Data Exchange Adapters


# Fiscal Information Dashboard

* [x] [Explore dashboard features](https://pfm.digit.org/exemplar/ifix-dashboard/features)&#x20;
* [x] [Browse dashboard architecture and technology details](https://pfm.digit.org/exemplar/ifix-dashboard/architecture)
* [x] [Install & deploy dashboards ](https://pfm.digit.org/exemplar/ifix-dashboard/installation)
* [x] [Configure dashboards](https://pfm.digit.org/exemplar/ifix-dashboard/documents/ifix-reference-dashboard/fiscal-event-aggregator)


# Works Management & Smart Payments

* [x] [Functional Scope](https://docs.digit.org/works/design-approach/approach) - Application features, functions, and capabilities
* [x] [Works Platform Architecture](https://docs.digit.org/works/platform/architecture) - Access Works platform high-level design and low-level design details
* [x] [Functional Specifications](https://docs.digit.org/works/specifications/functional-specifications) - Learn more about the functional details for the multiple services on the Works platform
* [x] [Service Configurations](https://docs.digit.org/works/setup/configure-works) - Access configuration documents for individual services
* [x] [Install Works Platform ](https://docs.digit.org/works/setup/install-works)- Browse through the installation and deployment steps
* [x] [Source Code](https://github.com/egovernments/DIGIT-Works) - Access the source code for DIGIT-Works on our open-source Github repo


# Water & Sanitation

Water & Sanitation is an open-source web and mobile-enabled application designed to digitise operations in the waste management value chain, from collection to treatment, and provides the ability to drive coordination across multiple independent and disconnected stakeholders. This ensures that there is a continued chain of custody of waste throughout.

Water & Sanitation is built on the principles of societal platforms, envisioning a space where sanitation is supported by shared resources, curated knowledge, and evolving solutions that address the needs of the community. By leveraging the Water & Sanitation solution, stakeholders can build innovative applications tailored to local contexts, while adhering to standardised components and data structures, leading to more effective and sustainable sanitation services.

Explore the reference applications for Water & Sanitation below:

* [Faecal Sludge Management](/welcome-aboard/products-and-solutions/water-and-sanitation/faecal-sludge-management-fsm)


# Faecal Sludge Management (FSM)

The Faecal Sludge Management (FSM) application is aimed at reducing the time taken for service delivery, establishing a chain of custody of waste from the point of collection to disposal, supporting data interoperability with other sanitation systems in the state, and improving sustainability by providing visibility and control to the government.

The application has been able to provide data and visibility to track service requests and understand the service delivery value chain, paving the way for process enhancements in FSM.

* [x] [Functional Scope ](https://docs.digit.org/sanitation/water-sanitation/solution-design)- Application features, functions, and capabilities
* [x] [User Manual](https://docs.digit.org/sanitation/water-sanitation-product-suite/waste-management-system/faecal-sludge-management-fsm/fsm-user-manual)
* [x] [API Specifications ](https://docs.digit.org/sanitation/water-sanitation-product-suite/waste-management-system/faecal-sludge-management-fsm/fsm-technical-specification)
* [x] [Service Configuration](https://docs.digit.org/sanitation/setup/configuration)


# Local Governance

DIGIT Urban Stack is a set of Open APIs, services, and reference implementations, set up as a public good, to allow government entities, businesses, startups, and civil society to use a unique digital Infrastructure and build solutions for urban India at a large scale. It provides a set of open standards, specifications and documentation to create a level playing field and enable ecosystem players to innovate on the stack. As a public good, the platform is provided without profit or restriction to all members of society.

Explore the urban reference applications below:

* [Local business license issuing system](/welcome-aboard/products-and-solutions/local-governance/local-business-license-issuing-system)
* [Property tax system](/welcome-aboard/products-and-solutions/local-governance/property-tax-system)
* [Water & sewerage connections](/welcome-aboard/products-and-solutions/local-governance/water-and-sewerage-connections)
* [Citizen complaint resolution system](/welcome-aboard/products-and-solutions/local-governance/citizen-complaint-resolution-system)
* [Residential construction permit system](/welcome-aboard/products-and-solutions/local-governance/residential-construction-permit-system)
* [mCollect - demand based revenue collection](/welcome-aboard/products-and-solutions/local-governance/mcollect)
* [Fire safety certification (NOC)](/welcome-aboard/products-and-solutions/local-governance/fire-safety-certification-noc)


# Local Business License Issuing System

* [x] [What's New](https://docs.digit.org/platform/release-notes/product-release-notes/trade-licence-reports-release-notes) - Latest release and enhancements in the module
* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-module-functional-specifications) - Application features, functions, and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual)
  * [Apply for New TL](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual#apply-for-new-tl)
  * [Renew Trade License](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual#renew-trade-license)
  * [View Application Status & Pay](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual#view-application-status-and-pay)
* [x] [Employee User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual)
  * [Create applications on behalf of citizens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#create-applications)
  * [Collect payment](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#collect-payment)
  * [Renew licence](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#renew-license)
  * [Process application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#process-application)
  * [Verify documents](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#verify-documents)
  * [Field inspection](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#field-inspection)
  * [Approve applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#approve-applications)
* [x] [Configure Trade License](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-service-configuration)
  * [Configure trade license calculator](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-service-configuration/trade-license-calculator)
  * [Configure trade license UI screens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-service-configuration/tl-ui-configuration)
  * [Configure trade license master data templates](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-master-data-templates)
* [x] [Configure National Dashboard For Trade License](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/trade-license-national-dashboard)
* [x] [Implementation Guide For Trade License Module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/trade-license-tl/tl-implementation-guide)


# Property Tax System

* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-module-functional-specifications) - Application features, functions, and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual)
  * [Register New Property​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/register-property)
  * [Search & Pay​ ​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/search-and-pay)
  * [My Bills](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/view-my-bills)
  * [My Payments​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/view-my-payments) ​
  * [My Properties ​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/view-my-properties)
  * [My Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/view-my-applications)
  * [Update Property](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/update-property) ​​
  * [Transfer Property Ownership​ ​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/transfer-property-ownership)
  * [Update Mobile Number](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/update-mobile-number)
  * [Amalgamate Property](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual/amalgamate-property)
* [x] [Employee User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual)

  Counter Employee:

  * [Search Properties](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/search-property)
  * [Search Application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/search-application)
  * [Employee Inbox](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/view-employee-inbox)
  * [Collect Property Tax](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/collect-property-tax)
  * [View Property Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/view-property-details)
  * [Payment History](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/view-payment-history)
  * [Register Property](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/register-property)
  * [Edit Property](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/edit-property)
  * [Assess Property](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/assess-property)
  * [Transfer Property Ownership](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/transfer-property-ownership)
  * [Edit Application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/edit-application)
  * [Reopen Application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/reopen-application)

  Document Verifier/Field Inspector/Approver

  * [Send Back Applications​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/send-back-applications)
  * [Reject Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/reject-applications)​ ​
  * [Verify and Forward Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/verify-and-forward)
  * [​Send Applications Back to Citizens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/send-back-to-citizen)​
  * [Approve applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-user-manual/employee-user-manual/approve-applications)
* [x] [Configure Property Tax](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service)
  * [Configure property mutation calculator](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service/property-mutation-and-mutation-calculator)
  * [Configure property tax calculator](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service/pt-calculator)
  * [Configure privacy for property tax module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service/pt-privacy-changes)
  * [Configure master data templates for property tax](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-master-data-templates)
  * [Configure UI screens for property tax module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service/pt-create-property-ui-details)
  * [Migrate legacy data to property tax module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/property-tax-service/pt-data-migration)
* [x] [Configure National Dashboards For Property Tax](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/property-tax-national-dashboard)
* [x] [Implementation Guide For Property Tax](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/property-tax/pt-implementation-guide)


# Water & Sewerage Connections

* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-module-functional-specifications) - Application features, functions, and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual)
  * [Search & Pay](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/search-and-pay)
  * [View Application Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/view-application-details)
  * [Pay Application Fees](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/pay-application-fees)
  * [Edit Application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/edit-application)
  * [View Connection Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/view-connection-details)
  * [View Consumption Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/view-consumption-details)
  * [Apply For Disconnection](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/apply-for-disconnection)
  * [View & Pay Bills](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/view-and-pay-bills)
  * [View Payment Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/view-payment-details)
  * [Apply For New Connection](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-citizen-user-manual/apply-for-new-connection)
* [x] [Employee User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual)

  Counter Employee:

  * [Apply for New Connections](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/apply-for-new-connections)
  * [Search Applications/Connections](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/search-applications-connections)
  * [Add Meter Readings](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/add-meter-readings)
  * [Activate New Connections](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/activate-new-connections)
  * [Collect Bill Payments](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/collect-bill-payments)
  * [Modify Connection Details](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/modify-connection-details)

  Document Verifier/Field Inspector/Approver

  * [Edit Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/edit-applications)
  * [Send Applications Back to Citizens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/send-applications-back-to-citizen)
  * [Reject Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/reject-applications)
  * [Verify and Forward Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/verify-and-forward-applications)
  * [Approve Connections](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-user-manual/w-and-s-employee-user-manual/approve-connections)
* [x] [Configure Water Services](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services)
  * [Configure water calculator service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-calculator-service)
  * [Configure water disconnection service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-service-disconnection)
  * [Configure water disconnection calculator service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-disconnection-calculator-service)
  * [Configure master data templates for water charges](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-charges-master-data-templates)
  * [Configure water & sewerage UI screens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-and-sewerage-service-ui-docs)
  * [Configure water & sewerage reports](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-and-sewerage-reports)
  * [Configure privacy for water & sewerage module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/water-and-sewerage-privacy-changes)
* [x] [Configure Sewerage Service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/sewerage-service)
  * [Configure disconnection service for sewerage](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/sewerage-service/sewerage-service-disconnection)
  * [Configure sewerage calculator service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/sewerage-service/sewerage-calculator-service)
  * [Configure disconnection calculator service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/water-services/sewerage-service/sewerage-disconnection-calculator-service)
  * [Configure master data templates for sewerage charges](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/sewerage-charges-master-data-templates)
* [x] [Configure National Dashboard For Water & Sewerage](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/w-and-s-national-dashboard)
* [x] [Implementation Guide For Water & Sewerage](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/water-and-sewerage/w-and-s-implementation-guide)


# Citizen Complaint Resolution System

* [x] [Functional Scope](https://docs.digit.org/complaints-management/access/pgr-functional-specifications) - Application features, functions and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/complaints-management/access/pgr-user-manual/citizen-user-manual)
  * [File complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/citizen-user-manual/file-complaints)
  * [View complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/citizen-user-manual/view-track-complaints)
  * [Rate complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/citizen-user-manual/rate-complaints)
  * [Reopen complaints](https://docs.digit.org/complaints-management/access/pgr-user-manual/citizen-user-manual/reopen-complaints)
* [x] [Employee User Manual](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual)

  CSR:&#x20;

  * [File Complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/csr-file-complaints)
  * [Search Complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/csr-search-track-complaints)
  * [Reopen Complaints](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/csr-reopen-complaints)

  GRO:

  * [Assign complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/gro-assign-complaints)
  * [Re-Assign complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/gro-reassign-complaints)
  * [Share complaints ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/gro-share-complaints)
  * [Reject complaints](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/gro-reject-complaints)

  FME:

  * [Request Re-Assign  ](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/fme-request-reassign)
  * [Resolve Complaints](https://docs.digit.org/complaints-management/access/pgr-user-manual/employee-user-manual/fme-resolve-complaints)
* [x] [Configure CMS services](https://docs.digit.org/complaints-management/deploy/configure)


# Residential Construction Permit System

* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-module-functional-specifications) - Application features, functions and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-citizen-user-manual)

  Citizens:

  * [Register Stakeholders](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-citizen-user-manual/register-stakeholders)
  * [View Application Status](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-citizen-user-manual/view-application-status)
  * [Request Edits and Approve Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-citizen-user-manual/request-edits-and-approve-applications)
  * [Make Payment](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-citizen-user-manual/make-payment)

  Stakeholders:

  * ​[Register Other Stakeholders​ ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/residential-construction-permit-system-stakeholders-user-manual/register-other-stakeholders)
  * ​[Submit for DIGIT-DCR Scrutiny ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/residential-construction-permit-system-stakeholders-user-manual/submit-for-digit-dcr-scrutiny)
  * [Submit for OC Plan Scrutiny​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/residential-construction-permit-system-stakeholders-user-manual/submit-for-oc-plan-scrutiny) ​
  * [Apply for Building Permits for New Construction​ ​](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/residential-construction-permit-system-stakeholders-user-manual/apply-for-building-permits-for-new-construction)
  * [Apply for Occupancy Certificates for New Building Construction](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/residential-construction-permit-system-stakeholders-user-manual/apply-for-occupancy-certificate)
* [x] [Employee User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual)

  Document Verifier/Field Inspector/NOC Verifier/Approver

  * [Send Applications Back to Citizens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual/send-applications-back-to-citizens)&#x20;
  * [Reject or Revoke Application ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual/reject-application-revoke-application)
  * [Verify and Forward Application](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual/verify-and-forward-application)
  * [Prepare Inspection Report ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual/prepare-inspection-report)
  * [Approve or Reject Application ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual/obpas-employee-user-manual/approve-reject-applications)
* [x] [Configure OBPAS Services](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration)
  * [Configure building plan application fee calculator service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/bpa-calculator-service)
  * [Configure building plan application service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/bpa-service-setup-and-configuration)
  * [Configure stakeholder registration service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/bpa-stakeholder-registration)
  * [Configure development control rules or eDCR](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/setting-up-edcr-service)
  * [Configure OBPAS UI screens](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/obpas-digit-ui)
  * [Configure master data templates for OBPAS](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/online-building-plan-approval-system-obpas/obpas-master-data-templates)
* [x] [Configure National Dashboards For OBPAS](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/obps-national-dashboard)


# mCollect

* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-functional-specifications)
* [x] Citizen User Manual
  * [Search, download and print receipts](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-user-manual/mcs-citizen-user-manual)
* [x] Employee User Manual
  * [Collect payment, search, print, and download payment receipts](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-user-manual/mcs-employee-user-manual)
* [x] [Configure master data templates for MCS module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-master-data-templates)
* [x] [Configure services for MCS module](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-service-configuration)
  * [Configure e-challan service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-service-configuration/e-challan-service)
  * [Configure calculator for e-challan](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-service-configuration/e-challan-service/echallan-calculator-services)
  * [Re-indexing configuration steps for MCS](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-service-configuration/re-indexing-the-mcollect-service)
* [x] [Configure UI screens for MCS](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/mcollect-mcs/mcollect-service-configuration/current-bill-cancellation-ui-flow)
* [x] [Configure National Dashboards for Miscellaneous Collections](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/mcollect-national-dashboard)


# Fire Safety Certification (NOC)

* [x] [Functional Scope](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-safety-certification-noc-functional-specifications) - Application features, functions and capabilities
* [x] [Citizen User Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-citizen-user-manual)
  * [Apply for Fire NOC](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-citizen-user-manual/apply-for-fire-safety-certificate-noc)
  * [Pay NOC Fees & View Application Status](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-citizen-user-manual/pay-noc-fees-and-view-application-status)
* [x] [Employee user Manual](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual)

  Counter Employee:

  * [Create and Submit New Application ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/create-new-application)
  * [View Application Status](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/view-application-status)

  Document Verifier/Field Inspector/Approver

  * [Forward Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/forward-applications)&#x20;
  * [Reject Applications ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/reject-applications)
  * [Refer Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/refer-applications)
  * [Send Back Applications ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/send-back-applications)
  * [Approve Applications](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/approve-applications)&#x20;
  * [Reject Applications ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-user-manual/fire-noc-employee-user-manual/reject-applications-1)
* [x] [Configure Fire NOC Service](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-service)
  * [Configure calculator service for Fire NOC ](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-service/fire-noc-calculator-service)
  * [Configure UI screens for Fire NOC](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/fire-noc/fire-noc-service/noc-digit-ui)
* [x] [Configure National Dashboards For Fire NOC](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/fire-noc-national-dashboard)


# Glossary

List of DIGIT platform-specific terms used in our docs

## Acronyms

ULB: Urban Local Bodies (municipality)

DIGIT: Digital Infrastructure for Governance, Impact & Transformation

MoHUA: Ministry of Housing and Urban Affairs, Government of India

NUDM: National Urban Digital Mission

DPG: Digital Public Good

Samaaj, Sarkaar, Bazaar: Society, government, market

NUGP: National Urban Governance Platform

NIUA: National Institute of Urban Affairs

SaaS: Software as a Service

MeITY: Ministry of Electronics and Information Technology

ICD: Classification of Diseases

JAM: Jan Dhan, Aadhar, Mobile

PT: Property Tax

PGR: Public Grievances Redressal

PMIDC: Punjab Municipal Infrastructure Development Company

DIVOC: Digital Infrastructure for Vaccination Open Credentials

SLA: Service Level Agreements

API: Application Programming Interface

ICT: Information, Communication and Technology

PFM: Public Finance Management

DoCA: Department of Consumer Affairs

TRAI: Telecom Regulatory Authority of India&#x20;

## Key Definitions

**Software Stack:** A software stack is a set of software subsystems or components needed to create a complete platform such that no additional software is needed to support applications. Applications are said to "run on" or "run on top of" the resulting platform. A complex software system is deconstructed into a stack using the principle of unbundling.&#x20;

Examples: [ELK (ElasticSearch-Logstash-Kibana)](https://www.elastic.co/elk-stack), LAMP (Linux, Apache, MySQL, PHP)

**Platform:** A platform is a plug-and-play business model that allows multiple participants (producers and consumers) to connect to it, interact with each other and create and exchange value. The vital aspect of platforms is that they afford interactions between people and services/products or other people. Platforms leverage underlying software stacks to facilitate these interactions.&#x20;

Examples: Sunbird (Education), DIGIT (Governance), Uber (Ride Platform), AirBnB (Accommodation Platform),&#x20;

**Platform Architecture:** An abstract description of the entities of a (software) system and how they are related. Among the most stable elements in a platform architecture are the modular interfaces (APIs ) that mediate between the platform and its complements. These interfaces are even more stable than the platform's interior core; thus, control over the interfaces amounts to control over the platform and its evolution.

Examples: [Android Platform Architecture](https://developer.android.com/guide/platform)

**Service:** A self-contained logical representation of a business activity with a specified outcome. Service may consist of other underlying services. Services can be components in a software stack.&#x20;

Examples: Tax Calculation Service, Content Management Service &#x20;

**Application:** Application software (app for short) is computer software designed to perform a group of coordinated functions, tasks, or activities for the benefit of the end user. Apps may be backed by an underlying platform.&#x20;

Examples: Bhim payment app, Uber rider app

**Programme:** a set of planned activities with predefined goals and objectives

Examples: Diksha, Ayushman Bharat

**Solution:** method or process to deal with a problem/challenge. Software applications enable parts of solutions.

Examples: Solid waste management, Traffic Management

**System:** An organised entity made up of interrelated and interdependent parts.

Examples: City, Computer

**Tenant: DIGIT** is a hierarchical multi-tenant system. The state can be a tenant. Departments can be the next-level tenant. So Punjab can be a tenant denoted by pb. The education department can be denoted by pb.education.&#x20;

**Role:** Role can be configured to provide a set of access to the user. The "Approver" Role allows users to approve or reject the application but does not allow the user to edit the application.&#x20;

**User:** When a user is created in DIGIT, they are mapped to tenant and role. So they have access only to those data that belong to that Tenant and can perform only those activities as defined in the role.&#x20;

**Workflow:** Workflow is defined as a set of states e.g. New, Submitted, Verified, Approved. At each stage, different roles can perform different actions e.g. Verifier can verify an application only when the application is in the "Submitted" state. Abstracting workflows allows DIGIT to configure different workflows for different tenants. For instance, if Jalandhar wants to configure additional roles and steps in the Birth Certificate process (as compared to Amritsar) then it will be possible to do so. \
\
**Registries:** A registry is data verified by a competent authority. Registries can be DPIs if the data is made available through APIs so that others can use the same enabling combinatorial innovations.&#x20;


# DIGIT Solutions Support

Welcome to DIGIT Solutions Support — your go-to space for help, guidance, and community collaboration while building on the DIGIT platform.

Whether you're:

* Setting up and Configuring a product powered by DIGIT
* Exploring or replicating a reference implementation
* Working on modifying a workflow or service to suit a local context

We're here to help you move forward..

### 🔧 What We Support

DIGIT Solutions Support covers any issue you may come across during deployment related to DIGIT Products and Solutions:

* Installation & configuration
* Master Data Management
* Reporting & dashboard analytics
* Workflow configuration
* UI customisation and styling
* API integration & management
* Performance tuning
* Product and platform configuration
* Infrastructure setup & monitoring
* Privacy and security guidance
* Repository & version control
* Version upgrades & migration
* Training and enablement resources

### 🗂 Where to Get Help

{% embed url="<https://github.com/egovernments/DIGIT-Core/discussions>" %}

Click on the above discussion board link. This is our primary support channel.

#### How to Ask a Question:

1. Go to the [Discussions tab](https://github.com/egovernments/DIGIT-Core/discussions)
2. Search for your issue to see if it’s already been answered
3. If not, click “New Discussion”
4. Select the relevant category and describe your issue

Our team—and the DIGIT community—will respond to guide you forward.

### 💡 Tips for Getting Help Faster

✅ Be specific – Explain the exact issue and what you've tried\
✅ Add context – Include logs, screenshots, or code samples\
🚫 Don’t post sensitive data – This is a public forum

DIGIT Solutions Support is here to unblock your team, provide clarity, and guide you toward scalable, impactful public service delivery.

We look forward to supporting you.

{% hint style="info" %}
To escalate a discussion or issue already raised in the GitHub Discussion Board, please email us at <digit-support@egovernments.org> with your Discussion or Issue ID (as applicable).
{% endhint %}


# FAQs

Commonly asked questions and its responses

## About DIGIT

<details>

<summary>What is DIGIT?</summary>

Digital Infrastructure for Governance, Impact & Transformation (DIGIT) is an open-source platform that helps governments deliver public services reliably. The platform enables effortless collaboration within or across government bodies, ensuring administrators and policymakers have access to the data needed for decision-making. Further, it provides frontline employees and government contractors with the information and tools needed on the ground to deliver services. The platform is continuously evolving with the needs and requirements of the governments to serve the changing needs and aspirations of their citizens.

Being open source, the platform empowers market players to design and implement innovative solutions that resolve societal problems. The open digital ecosystem empowers our partners to build system capabilities and run programs that promote ease of living, enable the development of local solutions and accelerate the impact on the ground.

The DIGIT platform is globally recognised for resolving e-governance challenges and is certified as a Digital Public Good (DPG) by the [Digital Public Goods Alliance (DPGA)](https://digitalpublicgoods.net/). Find the DIGIT platform in the [DPG registry](https://digitalpublicgoods.net/registry/) along with a host of other globally recognised DPGs.

</details>

<details>

<summary>What is the background and story of DIGIT?</summary>

DIGIT - Builds state capacity for public sector delivery through DPIs (Digital Public Infrastructure). It improves the translation of policy intent into on-ground execution. We started our journey with a vision of good governance being supported and enhanced by a digital backbone. We had seen that local governments had poor capacity due to:

1. human resource deficits (both adequate numbers and skill levels of staff)
2. financial deficits (ability to mobilise own revenues as well as the ability to spend in a strategic manner
3. policy blockers (either lack of policies or often multiple contradictory policies in the same domain)

We developed DIGIT to address these challenges:

1. shifting drudgework away from staff to digital systems (routine, repeatable, codified tasks are easier to automate/disintermediate) to drive improved efficiency in public service delivery
2. improving resource mobilisation by easing demand generation and collections of taxes, user charges, fees, licences etc
3. Surfacing relevant data to government administrators and functionaries to enable timely decision-making and action.

</details>

<details>

<summary>Who are the primary users of DIGIT?</summary>

1. Citizens - to avail, apply, track, pay service fees, and raise complaints for services.
2. Governments - to interact with the citizens, provide services and collect feedback.
3. Field employees/officers - primary users responsible for the daily operations and service delivery.
4. Administrators/decision makers - use dashboards to view progress on how services are being adopted by citizens and take course corrective actions and policy changes accordingly.

</details>

<details>

<summary>What are the benefits for governments or agencies using DIGIT?</summary>

Essentially, the benefits of this open-source platform can be viewed from short to long-term perspectives. The pointers below provide the phase-wise adoption impacts of the DIGIT platform as evidenced during DIGIT implementations.

First phase: Coordination costs decrease as the execution focuses on improving existing processes.

Second phase: Data-driven reforms and performance management enabled by more consistent, granular and timely data generated by the DPIs.

Third phase: Interoperability of DPIs across departments and ministries improves targeting of policy interventions and speed of execution and improved financial and operational efficiency.

Governments use DIGIT to enable DPIs for public service delivery and governance. The platform serves multiple domains including urban governance (collecting taxes and fees, providing certificates, services, and resolving grievances), improving sanitation management, strengthening public health systems, enabling better public finance management, and managing rural water supply operations to name a few. The implementations have improved state capacity through:

1. Consistent improvement in revenue collections across all geographies (this is often a leading indicator of state capacity).
2. Reduction in employee burden – across various geographical locations DIGIT delivers average time savings of 6 hours per week to frontline workers (findings from lean data survey).
3. Streamlined/re-engineered policies that reduce the paperwork and process burden on frontline workers and citizens.

Find more about the DIGIT value proposition [here](https://docs.digit.org/platform/platform/digit-value-proposition).

</details>

<details>

<summary>What is the DIGIT value proposition?</summary>

The DIGIT value proposition highlights the key capabilities and aspirations that form the foundational base of the technology platform. Accelerated reforms, trustworthiness, productivity, adoption, sustainability, ease of access, quick deployment, a strong network of system integrators, support and global recognition - These buzzwords reflect the robust design of the DPIs built on this platform, geared to resolve complex societal problems. DIGIT has carved its own niche space with its open-source platform ​​that leverages the capabilities of microservice design to promote responsive and agile governance solutions.

Find more about the DIGIT value proposition [here](https://docs.digit.org/platform/platform/digit-value-proposition).

</details>

<details>

<summary>What are the DIGIT platform capabilities?</summary>

DIGIT is a technology platform that offers multiple building blocks or microservices that can be reused by products or applications. The platform focuses on inclusion and is designed on the principle of enhancing both platform openness and choice for citizens. The platform uses open APIs and standards, creating a powerful framework to drive convergence across multiple systems currently in use and to lower the barrier to entry for locally-developed solutions.

Explore the DIGIT platform features in detail [here](/welcome-aboard/digit-platform).

</details>

<details>

<summary>What are the current applications/modules hosted on DIGIT?</summary>

DIGIT offers multiple modules that facilitate citizen services ranging from submitting public grievances to applying for trade licences, water or sewerage connections, paying property taxes or submitting applications for building permits. The platform also offers public finance management and faecal sludge management applications designed to ease the governance of funds and improve sanitation.

More about DIGIT modules [here](/welcome-aboard/products-and-solutions).

</details>

<details>

<summary>What are the upcoming features in DIGIT?</summary>

Planned release features and future enhancements for the next 4 quarters are available in our roadmap [here](https://core.digit.org/roadmap).

</details>

<details>

<summary>I want to see a demo of DIGIT. Where can I see it?</summary>

Access details for the demo of DIGIT applications and features are available below:

* To browse as a citizen, [click here](https://staging.digit.org/digit-ui/citizen).
* To browse as an employee, [click here](https://staging.digit.org/employee/language-selection).

Additional details on DIGIT platform resources and product areas are available [here](/).

You can also access the multiple videos on our [DIGIT Youtube](https://www.youtube.com/@digit_dpg) channel as well that provide a detailed walkthrough of the DIGIT modules and platform capabilities.

</details>

## Technical FAQs

<details>

<summary>What are the open source tools used to build, deploy and operate the DIGIT platform?</summary>

The list of open-source tools used is listed [here](https://docs.digit.org/platform/platform/architecture/technology-architecture).

</details>

<details>

<summary>What are the common DIGIT platform services that I can reuse?</summary>

List and details of common platform services such as notifications, file store, telemetry, payment gateway are listed [here](https://docs.digit.org/platform/platform/core-services).

</details>

<details>

<summary>Where can I find details about DIGIT architecture?</summary>

DIGIT is a microservices-based platform that is built to scale. All details about the architecture can be found [here](https://docs.digit.org/platform/platform/architecture).

</details>

<details>

<summary>What are the setup requirements? What technical skills do I need to set up or use DIGIT?</summary>

Setup requirements and technical skills required on the team can be found [here](/welcome-aboard/digit-platform).

</details>

<details>

<summary>Where can I find the API specs for DIGIT core services?</summary>

The API specs for all core services are listed [here](https://specs.digit.org/common-service-specs).

You can also explore the various application specs [here](https://specs.digit.org/).

</details>

<details>

<summary>Does DIGIT offer analytics dashboards for visualisation of data?</summary>

Yes, the DIGIT National Dashboard Ingest service provides a one-stop framework for ingesting data from defined sources based on configuration. More about dashboards [here](https://docs.digit.org/local-governance/local-governance-product-suite/local-governance-stack/dashboards-and-analytics).

</details>

<details>

<summary>Is it interoperable with other DPGs? Can it interoperate with other systems?</summary>

1. DIGIT uses micro-service architecture and is interoperable with other DPGs exposing integration APIs
2. Relevant integration adaptors/connectors would need to be developed for this integration
3. For example -

</details>

<details>

<summary>What does “Building Blocks Approach” mean?</summary>

Digital building blocks are conceptually similar to physical building blocks with a few key differences

* Easier and (almost) free to replicate
* Exchange info to complete a task
* Can be simultaneously used
* Evolved differently in multiple solutions

Building blocks are the key design choice to enable solutions to evolve. The following diagram conceptually illustrates how building blocks make evolution possible.

</details>

<br>


# The concept of Tenant in DIGIT

#### What is a tenant?

In the context of software architecture, a "tenant" typically refers to an individual or organization that uses a shared software application or service. Each tenant operates within its isolated portion of the application's resources, such as data, configuration, and user interface.

#### What is a multitenant system?

Multitenancy refers to a software architecture where a single instance of the software serves multiple tenants or clients. Each tenant typically has its own isolated and customizable environment, but they all share the same underlying infrastructure and codebase.

In a multitenant system, tenants are often distinguished by factors such as data, configuration, user interface, and access rights. This architecture is commonly used in cloud-based applications, where it allows software providers to efficiently serve multiple customers while minimizing infrastructure costs and maintenance efforts.

For example, in a multitenant web application, each tenant might have its own database or database schema or data partition, ensuring data isolation and security. However, all tenants share the same application codebase and runtime environment, reducing overhead and simplifying updates and maintenance.

#### Goals and Objectives

* Implement multi-tenancy to support multiple tenants within a single instance of the platform and product.
* Enable creation, updating, and searching of tenants/accounts&#x20;
* Ensure data isolation and security by enforcing tenant-level authorization.
* Provide configuration options for administrators to customize system behaviour.

#### Key Stakeholders

* Development Team
* Project Stakeholders
* End Users


# Introducing Local Governance

The digital local governance solution

## About Local Governance

The DIGIT-powered local governance solution catalyses digital transformation across towns and cities - changing how citizens interact with government bodies. As a digital public good, the DIGIT Local Governance stack fosters an open digital ecosystem, enabling co-creation and deployment of locally relevant solutions that enhance business operations and improve overall quality of life. By transforming local governance, this initiative not only elevates citizen well-being but also accelerates the nation's economic growth.

## Useful Links

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Local governance</strong></mark></td><td>Overview of challenges and approach used to resolve with DIGIT Local Governance module</td><td></td><td><a href="/spaces/OorNqx5By246mkjipsn7/pages/z01m5po8mjFNGrJzS8wI">/spaces/OorNqx5By246mkjipsn7/pages/z01m5po8mjFNGrJzS8wI</a></td></tr><tr><td><mark style="color:blue;"><strong>Product Specifications</strong></mark></td><td>Explore the local governance product suite functional specifications &#x26; user module details</td><td></td><td><a href="/spaces/OorNqx5By246mkjipsn7/pages/01KmDPmaqxM8w7IRnGmv">/spaces/OorNqx5By246mkjipsn7/pages/01KmDPmaqxM8w7IRnGmv</a></td></tr><tr><td><mark style="color:blue;"><strong>Technology</strong></mark></td><td>Find the tech building blocks details for local governance</td><td></td><td><a href="/spaces/OorNqx5By246mkjipsn7/pages/MIzdVxXMTkdHhMuHpTVz">/spaces/OorNqx5By246mkjipsn7/pages/MIzdVxXMTkdHhMuHpTVz</a></td></tr><tr><td><mark style="color:blue;"><strong>Setup</strong></mark></td><td>Plan, gather requirements, install and configure modules</td><td></td><td><a href="/spaces/OorNqx5By246mkjipsn7/pages/eaxC3Q8cYyniHJPeraPd">/spaces/OorNqx5By246mkjipsn7/pages/eaxC3Q8cYyniHJPeraPd</a></td></tr></tbody></table>

## Contact Us

{% embed url="<https://egov.org.in/contactegov>" %}


# Release Notes

v2.9 - new release features, enhancements, and fixes

## Release Summary <a href="#release-summary" id="release-summary"></a>

Local Governance 2.9 release includes the following changes:

* [x] Citizen Consent Form
* [x] Citizen Feedback Rating
* [x] KPI List (National Dashboard)
  * Citizen Feedback Score
  * Citizen Service Delivery Index
  * Aggregated SLA
  * Pendancy
* [x] mCollect (demand-based revenue collection) Pdf -QR code bug fix/alignment issues
* [x] Residential Construction Permit System - bug fixes
* [x] Local Business License Issuing System - bug fixes
* [x] Property Tax System - bug fixes
* [x] Finance - bug fix
* [x] Central Instance-related changes for modules - Property Tax, Trade License, Citizen Complaint Resolution System, Residential Construction Permit System, Water and Sewerage Connections, Fire Safety Certification, Birth and Death, mCollect, Reports and Inbox.

## New ‌Feature Additions <a href="#new-feature-additions" id="new-feature-additions"></a>

<table><thead><tr><th width="233">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Citizen Consent Form</td><td>This feature is to get a consent from the citizen during the citizen login</td></tr><tr><td>Citizen Feedback Rating</td><td>This feature is focused to get a citizen rating when a service is completed.</td></tr><tr><td>NDSS KPIs</td><td><p>This includes</p><ul><li>Citizen Feedback Score</li><li>Citizen Service Delivery Index</li><li>Aggregated SLA</li><li>Pendancy</li></ul></td></tr><tr><td>Central Instance</td><td>This feature includes changes related to central instance for modules - Property Tax, Trade License, PGR, OBPS, Water and Sewerage, Firenoc, Birth and Death, mCollect, Reports, Inbox</td></tr></tbody></table>

## Enhancements <a href="#enhancements" id="enhancements"></a>

<table><thead><tr><th width="140">Updated Feature</th><th width="343">Description</th><th width="115">Category</th><th>Change Link</th></tr></thead><tbody><tr><td>PT bugs</td><td>While creating a new property the Institution name allowing special characters,institution-type options updated,in PDF, showing the proper name of the usage type.</td><td>Frontend</td><td> </td></tr><tr><td>TL</td><td>Create New Application from CE end and TL Renewal billing slab issues.</td><td>Frontend</td><td> </td></tr><tr><td>Finance</td><td>Total bill amount not showing proper</td><td>Frontend</td><td> </td></tr><tr><td>Common</td><td>Fetch bill api issue, Localisations issue in release kit.</td><td>Frontend</td><td> </td></tr><tr><td>mCollect</td><td>UI alignment issue, Payer's Name is not visible while scanning the QR code, The footer is overlapping the drop down.</td><td>Backend</td><td><a href="https://github.com/egovernments/configs/pull/2646">Config change</a></td></tr></tbody></table>

## ‌Document Resources & Links <a href="#document-resources-and-links" id="document-resources-and-links"></a>

<table><thead><tr><th width="351">UI Technical Documents</th><th>Backend Service Documents</th></tr></thead><tbody><tr><td><p><strong>New Docs</strong></p><p><a href="/pages/y1vOZvl9GwenuXrcR2ws">Citizen consent form</a><br><a href="/pages/dEGRNLp57QdtS5aCxAKs">Citizen Feedback UI</a><br><a href="/pages/dBgiyen7HQVkK89p8s3T">UI build preparation for new instance</a></p></td><td><p><strong>New Docs</strong></p><p><a href="/pages/RUw3MC5xTuXYTvcr3bsK">KPIs: Pendancy, Citizen Feedback and Pt-SLA changes</a></p><p><a href="/pages/nCQPKF1iy8HqyBAQ2JYJ">Citizen feedback Service</a><br><a href="/pages/rABUiwY24JnTcfyR8J0l">DIGIT SAAS Guideline - Central Instance</a></p></td></tr><tr><td></td><td></td></tr></tbody></table>


# Master Migration Document

2.9 release master migration document

## **Overview**

This page contains the changes related to core and municipal services along with the MDMS, DevOps and configuration setups required to accommodate multi-tenancy. Browse through the details below to learn more about the Central Instance.&#x20;

Refer to[ SAAS Guidelines for Central Instance](https://app.gitbook.com/o/-MEQmzNGXk5ajuZujG7E/s/F18990sRPMwVnnjjJxWc/~/changes/18/platform/release-notes/master-migration-document/saas-guideliness-cental-instance) to find additional information.

## Migration Steps

### **Service-request Module - Citizen Feedback Module**

The service-request module is required for the surveys to work.\
Follow the steps given below:

1. Add the [Service-request module](/local-governance/access/local-governance-stack/citizen-engagement-module/citizen-engagement-configuration/service-request)
2. Add the new persister file: [service-request-persister](https://github.com/egovernments/configs/blob/UAT/egov-persister/service-request-persister.yml)
3. Add the [Helm chart](https://github.com/egovernments/DIGIT-DevOps/tree/master/deploy-as-code/helm/charts/core-services/service-request)&#x20;
4. Configure the build&#x20;

{% code lineNumbers="true" %}

```yaml
- name: "builds/digit-dev/core-services/service-request"
    build:
      - work-dir: "core-services/service-request"
        image-name: "service-request"
        dockerfile: "build/maven/Dockerfile"
      - work-dir: "core-services/service-request/src/main/resources/db"
        image-name: "service-request-db"
```

{% endcode %}

5. Make the role action-mapping changes in the MDMS

[AccessControl Actions Test](https://github.com/egovernments/egov-mdms-data/blob/UAT/data/pg/ACCESSCONTROL-ACTIONS-TEST/actions-test.json#L14597)

[AccessControl Role Actions](https://github.com/egovernments/egov-mdms-data/blob/UAT/data/pg/ACCESSCONTROL-ROLEACTIONS/roleactions.json#L25805)

6. Click on the Job-builder once the above steps are complete.
7. Restart the following services: egov-accesscontrol, egov-mdms-service, egov-persister
8. Deploy the service-request module build

   For further details on how to use Citizen-feedback APIs refer to the [Citizen Feedback service](/local-governance/access/local-governance-stack/citizen-engagement-module/citizen-engagement-configuration/citizen-feedback-service).
9. Create the Citizen Feedback Service definitions (as mentioned in the above Citizen Feedback Service document) for modules and flows as per requirement before using it on the UI.

{% hint style="info" %}
**Note:** Service definition creation is a backend task that requires sending an API request using tools like Postman. This task is typically performed once during the initial setup process.
{% endhint %}

### **New KPIs**

1. Refer to [KPIs: Pendancy, Citizen Feedback and Pt-SLA changes](/local-governance/access/local-governance-stack/dashboards-and-analytics/dashboards-and-analytics-service-configuration/kpis-pendancy-citizen-feedback-and-sla-changes) and make changes as per the document.
2. Restart dashboard analytics with Cluster-configs.

### **UI Migration Changes**

* **Central Instance:**

Find the details for prepping the UI build for a new instance.

[UI build preparation for a new instance](/local-governance/deploy/configure-digit/configuring-digit-services/central-instance-configuration/ui-build-preparation-for-new-instance)

* **Citizen Consent Form:**

This feature allows citizen users to give their consent at the time of logging in.

Add this MDMS [file](https://github.com/egovernments/egov-mdms-data/blob/QA/data/pb/common-masters/CitizenConsentForm.json)&#x20;

**Documentation:**\
a. Refer to [Citizen Consent Form](/local-governance/access/local-governance-stack/citizen-engagement-module/citizen-engagement-configuration/citizen-consent-form-ui)\
b. Restart MDMS and deploy the latest front-end builds.

* **Citizen Feedback:**

A functionality that allows users to provide the user facility to submit feedback/ratings at the end of the service.

Add the MDMS file available here: <https://github.com/egovernments/egov-mdms-data/blob/QA/data/pb/common-masters/RatingAndFeedback.json>

{% code lineNumbers="true" %}

```json
{
  "tenantId": "pb",
  "moduleName": "common-masters",
  "RatingAndFeedback": [
    {
      "type": "isCitizenRatingEnabled",
      "value": true
    },
    {
      "type": "headerByRating",
      "value": [
        {
          "minvalue": 1,
          "maxvalue": 3,
          "code": "CS_WHAT_WENT_WRONG"
        },
        {
          "minvalue": 4,
          "maxvalue": 5,
          "code": "CS_WHAT_WENT_GOOD"
        }
      ]
    },
    {
      "type": "enabledScreensList",
      "value": [
        {
          "module": "PT",
          "bussinessService": "PT_CREATE",
          "screenfrom": "pt/property/new-application/acknowledgement",
          "cardHeader": "PT_RATE_HELP_TEXT_CREATE",
          "cardText": "PT_RATE_CARD_TEXT_CREATE"
        },
        {
          "module": "PT",
          "bussinessService": "PT_MUTATION",
          "screenfrom": "pt/property/property-mutation/acknowledgement",
          "cardHeader": "PT_RATE_HELP_TEXT_MUTATE",
          "cardText": "PT_RATE_CARD_TEXT_MUTATE"
        },
        {
          "module": "PT",
          "bussinessService": "PT_UPDATE",
          "screenfrom": "pt/property/edit-application/acknowledgement",
          "cardHeader": "PT_RATE_HELP_TEXT_UPDATE",
          "cardText": "PT_RATE_CARD_TEXT_UPDATE"
        },
        {
          "module": "PT",
          "bussinessService": "PT",
          "screenfrom": "digit-ui/citizen/payment/success",
          "cardHeader": "PT_RATE_HELP_TEXT_PAY",
          "cardText": "PT_RATE_CARD_TEXT_PAY"
        }
      ]
    }
  ]
}
```

{% endcode %}

In the provided configuration, the parameter `headerByRating` is utilized to specify the value for the star condition, along with the corresponding message to be displayed on the UI screen. The `enabledScreensList` parameter is used to indicate the specific flows where the Citizen feedback screen will be presented, allowing citizens to provide reviews.

The rating component is utilized for displaying star ratings on the citizen feedback screen. You can locate this component within the micro-ui-internals folder on the following GitHub link: [Rating.js](https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/react-components/src/atoms/Rating.js).

**Documentation**

a. Refer to [Citizen Feedback Documentation](/local-governance/access/local-governance-stack/citizen-engagement-module/citizen-engagement-configuration/citizen-feedback-ui) for more details.

b. Restart MDMS and deploy the latest front-end builds.

&#x20;


# DIGIT SAAS Guideline - Central Instance

## Overview

The page assumes that the deployment of the central instance will happen in a Kubernetes-based environment independent of whether it’s a cloud-based or a bare metal deployment with a Kubernetes-based orchestrator. This page lists all types of services available in a DIGIT SAAS package and the steps to deploy, implement, and add a new service.

### Useful Terms

**Namespace/deployment-space** - refers to the Kubernetes namespace or the equivalent by establishing access restrictions.

**State/Tenant** - A state is a separate entity whose applications and data are separated from the rest by namespaces and schemas in the database.

## Deployment Setup

1. **Backbone Services** - The backbone services include Kafka, Redis, and Elastic stack. The number of deployments and the namespace where the services will be deployed are taken care of by the deployment manager itself.
2. **State Deployment space - Namespace -** In DIGIT SAAS, the private application/deployment space (namespace in K8s & schema in DB) is provided for different tenants (states) when they onboard, the steps to create and provide the same are mentioned in the following document.
3. **Central/Shared Services** - In DIGIT SAAS, each new tenant is given a separate namespace, but most use some unmodified out-of-box services provided by DIGIT deployed in a shared space known as the central namespace. These sets of services include some of DIGIT’s core services and registries. Among the services mentioned some can never be modified by the state (tenant) actors and some can be modified. In case of any modification, the services should be deployed in their own space.
   * [x] 1.3.1 The unmodifiable core services are listed below:
     * user(egov-user + egov-otp + user-otp )
     * API-Gateway(Zuul + Access Control + nginx-ingress controller)
     * Internal gateway
     * Workflow
     * Persister
     * Indexer
     * Report
     * Searcher
     * HRMS
     * Localisation
     * Location
     * NDSS
     * MDMS

The above-mentioned services cannot be modified by the state actors and should only be deployed in the central/shared namespace.

* [x] The modifiable registries&#x20;
  * Registries of any kind are provided by eGov out of the box and are not customized by the state actors. for  ex property-registry, TradeLicense-registry etc..,
  * These registries should be deployed in the central namespace to improve usage and reduce cost.
  * When there are modifications to the service then the same has to be deployed in the state’s own deployment space.

### 4. State services

The services that are by default deployed and run in the state namespaces whether there are modifications or not. Since they have functionalities that are directly related to the specific requirement of the state.

These services can be divided into multiple categories -

* [x] **User Interface** - The DIGIT UI by default requires customisation related to the state(tenant), hence will always be deployed in state-specific deployment spaces.
* [x] **Core state services** (Unmodifiable) - The DIGIT core services will be deployed in state-specific deployment spaces due to their nature of being dependent on the state(tenant) base configs.
  * MDMS
  * Notification SMS
  * Notification email
  * User event
  * IDgen
  * Payment gateway service
* [x] **Utility services** - The utility services are always state config dependent hence they will be deployed in the state-specific spaces.
  * Pdf
  * Inbox
  * DSS
  * EDCR
  * Finance
* [x] Calculators - The calculation logic requirement will mostly change along with the state-specific configs hence they are by default deployed in state-specific spaces.
  * Property
  * Trade License
  * Water
  * Sewerage etc..

## Configuration Setup

The DIGIT applications require different types of config setup, they are as follows the MDMS data, persister, indexer, pdf, report, searcher and internal gateway.

### 1. MDMS Data

The MDMS data is required for the Master data management service to supply the data required by other modules to perform their basic validation and verify the validity of the data. The prescribed format of the same can be found in the application setup. Since the application is deployed in all the namespaces central and state. Each deployment will need its own GitHub repo.

Central MDMS - central MDMS repo

State 1 MDMS - state1 MDMS repo

### 2. Persister & Indexer

The persister and indexer configuration for all states should be added in a single GitHub repo in the same branch. Since both applications run in a single place. Each state deployment will have to modify their KAFKA topic names with a prefix of their state schema name.

| Persister Topic Name | State 1                | State 2                |
| -------------------- | ---------------------- | ---------------------- |
| save-property        | state1-save-property   | state2-save-property   |
| update-property      | state1-update-property | state2-update-property |

### 3. PDF

The pdf configs have to be added in a separate repository since the format of pdfs printed will change with each different tenant.

### 4. Report & Searcher

The configs of report and searcher have to be added in the same GIT repo and same branches as the persister and indexer. The additional change that needs to be done here is that their URL should be appended with state schema names like the topic names with persister config.&#x20;

|                                              | State 1                                          | State 2                                          |
| -------------------------------------------- | ------------------------------------------------ | ------------------------------------------------ |
| <p>reportName:<br>AssetImmovableRegister</p> | <p>state1\_AssetImmovableRegister</p><p><br></p> | <p>state2\_AssetImmovableRegister</p><p><br></p> |
| - name: billswithaddranduser                 | state1\_billswithaddranduser                     | state2\_billswithaddranduser                     |

### 5. Internal Gateway

The internal gateway config should be added to the [central git config repo](https://github.com/egovernments/configs/blob/central-instance/internal-gateway.json) since the app is deployed in the central namespace.

## Development Guide

The development of any service in DIGIT should be based on this development guide.&#x20;

### 1. Common Update For All Services

The following library versions are a minimum requirement before any service can be made central instance compatible.

**Changes to pom.xml**

1. Add Tracer 2.1.1 and above

{% code overflow="wrap" %}

```xml
<dependency>
	<groupId>org.egov.services</groupId>
	<artifactId>tracer</artifactId>
	<version>2.1.1-SNAPSHOT</version>
</dependency>
```

{% endcode %}

2. Services-common 1.1.0 and above

```xml
<dependency>
	<groupId>org.egov.services</groupId>
	<artifactId>services-common</artifactId>
	<version>1.1.0-SNAPSHOT</version>
</dependency>
```

3. MDMS-Client 0.0.4 and above

```xml
<dependency>
	<groupId>org.egov</groupId>
	<artifactId>mdms-client</artifactId>
	<version>0.0.4-SNAPSHOT</version>
</dependency>
```

4. ENC-Client 2.04 and above

```xml
<dependency>
	<groupId>org.egov</groupId>
	<artifactId>enc-client</artifactId>
	<version>2.0.4-SNAPSHOT</version>
	<exclusions>
		<exclusion>
			<groupId>org.springframework.kafka</groupId>
			<artifactId>spring-kafka</artifactId>
		</exclusion>
		<exclusion>
			<groupId>org.apache.kafka</groupId>
			<artifactId>kafka-clients</artifactId>
		</exclusion>
	</exclusions>
</dependency>
```

### 2. Multi-Schema Services List

The following document helps to make multi-environment applications (**Services which will run in the DIGIT namespace but store their data in state-specific namespaces of DB based on tenant-id**) central instance compatible. These services include the likes of -

1. Billing-service
2. Collection-service
3. workflow-service
4. egov-apportion-service
5. egov-hrms
6. All the municipal registries
7. Property-services
8. TL-services
9. PGR-services
10. bpa-services
11. echallan-services
12. firenoc-services
13. land-services
14. noc-services
15. sw-services
16. ws-services

Any service that needs to share its data among multiple DB schemas can be added to the above category.

### 3. Migration Changes For Multi-Schema Services

Certain services in the Central-instance will only be deployed in the central (DIGIT) namespace but their data needs to be stored in different schema belonging to different state namespaces. The migrations of foretold services need to be run in all Required schemas (for instance: namespaces that want to make use of the centrally deployed services). To enable the above functionality the following changes are required.

1. Migrate.sh

This file is needed for building migration docker image is located in the DB folder of resources. eg: [property-services/src/main/resources/db/**migrate.sh**](https://github.com/egovernments/DIGIT-Dev/blob/central-instance-changes/municipal-services/property-services/src/main/resources/db/migrate.sh)**.** Update the file with the following contents:

```sh
#!/bin/sh
baseurl=$DB_URL
echo "the baseurl : $DB_URL"
schemasetter="?currentSchema="
schemas=$SCHEMA_NAME
echo "the schemas : $schemas"
for schemaname in ${schemas//,/ }
do
    echo "the schema name : ${baseurl}${schemasetter}${schemaname}"
    flyway -url=${baseurl}${schemasetter}${schemaname}  -table=$SCHEMA_TABLE -user=$FLYWAY_USER -password=$FLYWAY_PASSWORD -locations=$FLYWAY_LOCATIONS -baselineOnMigrate=true -outOfOrder=true -ignoreMissingMigrations=true migrate
done
```

2. values.yml

The DB configuration is by default provided in the common[ values.yml](https://github.com/egovernments/DIGIT-DevOps/blob/central-instance/deploy-as-code/helm/charts/common/values.yaml) file in the helm chart and need not be edited in normal scenarios. Since we are injecting the multiple schema list for app-specific purposes all the DB-migration ENV variables should be overridden in the app-specific values.yml file.

\#Values.yml of the specific service **before** multiple schema changes

```yaml
# Init Containers Configs
initContainers:
  dbMigration:
    enabled: true
    schemaTable: "property_services_schema"
    image:
      repository: "property-services-db"
```

\#Values.yml of the specific service after multiple schema changes.

[<img src="https://github.githubassets.com/favicon.ico" alt="" data-size="line">values.yaml](https://github.com/egovernments/DIGIT-DevOps/blob/central-instance/deploy-as-code/helm/charts/municipal-services/property-services/values.yaml) - the full updated sample file can be found here

<pre class="language-yaml"><code class="lang-yaml"><strong># Init Containers Configs
</strong>initContainers:
  dbMigration:
    enabled: true
    schemaTable: "property_services_schema"
    image:
      repository: "property-services-db"
    env: |
        {{- if index .Values "property-ismultischema-enabled" }}        
        - name: SCHEMA_NAME
          value: {{ index .Values "property-schemas" | quote }}
        {{- end }}
        - name: "DB_URL"
          valueFrom: 
            configMapKeyRef: 
              name: egov-config
              key: db-url
        - name: "SCHEMA_TABLE"
          value: {{ .Values.initContainers.dbMigration.schemaTable | quote }}              
        - name: "FLYWAY_USER"
          valueFrom: 
            secretKeyRef: 
                name: db
                key: flyway-username
        - name: "FLYWAY_PASSWORD"
          valueFrom:
            secretKeyRef: 
                name: db
                key: flyway-password
        - name: "FLYWAY_LOCATIONS"
          valueFrom: 
            configMapKeyRef: 
                name: egov-config
                key: flyway-location
</code></pre>

Only the `- name: SCHEMA_NAME` variable needs to be added and other fields can be copied from the common [values.yml](https://github.com/egovernments/DIGIT-DevOps/blob/central-instance/deploy-as-code/helm/charts/common/values.yaml#L39) as it is without any changes. The above file contains an if-else condition with two new variables

```yaml
{{- if index .Values "property-ismultischema-enabled" }}        
- name: SCHEMA_NAME
  value: {{ index .Values "property-schemas" | quote }}
{{- end }}
```

The `"property-ismultischema-enabled"` Boolean value to check if the feature is enabled and `"property-schemas"` to derive the value from respective environments YAML. This example of two variables should be named differently based on service-name to avoid conflicts.

3. Environments.yml

In the respective environment’s file add the two new variables, one for the if condition and the other field for actual values under the respective service names. Lines 6 and 7 are the sample values provided here.

eg :

```yaml
property-services:
  property-schemas: 'public,statea,stateb'
  property-ismultischema-enabled: 'true'
```

### 4. Code Changes For Multi Schema Services&#x20;

Any services that could potentially be commonly used by all environments in the central instance (refer to [Multi Schema Service List](#2.-multi-schema-services-list) for details).

**Application.properties** variables to be added.

1. ***state.level.tenantid.length***=2\
   State-level tenant value will be picked from the full tenant-id separated by the '.' dot. once the tenant-id is separated by a dot the resulting array of sizes given above will be considered state level.
2. **is.environment.central.instance**=true

   Declares whether the environment in which the service is deployed belongs to a central-instance kind of setup.
3. The both above said variable has to be overridden in the values YAML file of the respective service to pick up the values from the environment.

```yaml
  {{- if index .Values "global" "is-environment-central-instance" }}        
  - name: IS_ENVIRONMENT_CENTRAL_INSTANCE
    valueFrom:
      configMapKeyRef:
        name: egov-config
        key: is-environment-central-instance
  {{- end }}
  {{- if index .Values "global" "is-environment-central-instance" }}        
  - name: STATE_LEVEL_TENANTID_LENGTH
    valueFrom:
      configMapKeyRef:
        name: egov-config
        key: state-level-tenantid-length
  {{- end }}
```

4. The host of the state-specific services referred by this service should be changed to the **internal gateway** host for tenant-based(namespace) redirection.

```yaml
  - name: EGOV_MDMS_HOST
    valueFrom:
      configMapKeyRef:
        name: egov-service-host
        key: internal-gateway
```

[Sample values YAML](https://github.com/egovernments/DIGIT-DevOps/blob/central-instance/deploy-as-code/helm/charts/municipal-services/property-services/values.yaml) file to refer to the above-said changes

5. If this service allows the search of data without tenant-id then the following validation should be added to all the search APIs belonging to the service. searches without state-level tenant-id (as described by this variable - ***state.level.tenantid.length***) will render the application useless, so the following is mandatory

```java
if(configs.getIsEnvironmentCentralInstance() && criteria.getTenantId() == null) 
  throw new CustomException("EG_PT_INVALID_SEARCH",
                                      " TenantId is mandatory for search ");
                                      
else if(configs.getIsEnvironmentCentralInstance() 
    && criteria.getTenantId().split("\\.").length < configs.getStateLevelTenantIdLength())
 throw new CustomException("EG_PT_INVALID_SEARCH",
       " TenantId should be mandatorily " + configs.getStateLevelTenantIdLength() + " levels for search");
```

6. Update the Kafka producer in the service with the following code to enable the service to post to a tenant (namespace) specific topic based on the tenant-id.

```java
@Service
@Slf4j
public class Producer {

	@Autowired
	private CustomKafkaTemplate<String, Object> kafkaTemplate;
	
	@Autowired
	private PropertyConfiguration configs;

	public void push(String tenantId, String topic, Object value) {

		String updatedTopic = topic;
		if (configs.getIsEnvironmentCentralInstance()) {

			String[] tenants = tenantId.split("\\.");
			if (tenants.length > 1)
				updatedTopic = tenants[1].concat("-").concat(topic);
		}
		log.info("The Kafka topic for the tenantId : " + tenantId + " is : " + updatedTopic);
		kafkaTemplate.send(updatedTopic, value);
	}
} 
```

7. Replace all the table names in the queries present with the {schema} placeholder

{% code overflow="wrap" %}

```java
private static String PROEPRTY_AUDIT_QUERY = "select property from {schema}.eg_pt_property_audit where propertyid=?";
```

{% endcode %}

8. Add the following Schema replacer utility method and use the same to replace all queries with the respective schema.

```java
/* * add this variable to your constant class */
public static String SCHEMA_REPLACE_STRING = "{schema}"; /** * Method to fetch the state name from the tenantId * * @param query * @param tenantId * @return */
public String replaceSchemaPlaceholder(String query, String tenantId) {
    String finalQuery = null;
    if (tenantId.contains(".")) {
        String schemaName = tenantId.split("\\.")[1];
        finalQuery = query.replace(Constants.SCHEMA_REPLACE_STRING, schemaName);
    } else {
        finalQuery = query.replace(Constants.SCHEMA_REPLACE_STRING.concat("."), "");
    }
    return finalQuery;
} 

/* * Sample method example to replace query with schema */
public List < String > getPropertyIds(Set < String > ownerIds, String tenantId) {
    List < Object > preparedStmtList = new ArrayList < > ();
    String query = queryBuilder.getQuery(ownerIds, tenantId, preparedStmtList);
    query = util.replaceSchemaPlaceholder(query, tenantId);
    return jdbcTemplate.queryForList(query, preparedStmtList.toArray(), String.class);
}
```

9. Change the persister config to alter the Kafka topic names for the configs belonging to your respective multi-schema service. The Kafka topic name should be appended with the schema name of the respective state schema.

<figure><img src="/files/lvIMmMt66JhAzqyE3KOv" alt=""><figcaption><p>persister config</p></figcaption></figure>

### 5. Central Instance Enabled Development&#x20;

Whether a service is going to be deployed in a central instance or not, it should follow and integrate with the central instance util library of common services.

1. Refer to the common update document [3.1 General update for services to be Central-Instance compatible](#3.1-common-update-for-all-services).
2. Make use of centralInstanceUtil class to perform any tenantId manipulations. Manual manipulation of tenantId is to be avoided for common purposes like getting state-level tenantId, and state-specific Kafka topics. Read the following methods from MultiStateInstanceUtil class found in the common-services package and make use of them as mentioned in the document.

{% file src="/files/rqEaRcL0t6o9aRCjWswG" %}

3. New environment variables are to be added mandatorily for environments.

```yaml
is.environment.central.instance=false
state.level.tenantid.length=2
state.schema.index.position.tenantid=1
```

4. The environment should be set to false when the current server is not for multi-state(non-central-instance), disabling and enabling this make the methods in the multiStateUtil class behave as required.
5. The state-level tenant length describes what part of the whole tenantId represents the state part. for eg: in tenantId “**in.statea.tenantx”.** in.statea represents the state part so the value will be 2.
6. The schema index position points to the substring of the tenantId whose value represents the schema name of the database for the given state.


# MDMS & Configuration Updates

MDMS & Configuration Updates for 2.9 Release

## **MDMS Changes**

| Feature                                 | Service  Name | Changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Description                |
| --------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
|                                         |               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | DIGIT 2.9 release changes. |
| Citizen Feedback & Citizen consent form |               | [3048](https://github.com/egovernments/egov-mdms-data/pull/3048), [3049](https://github.com/egovernments/egov-mdms-data/pull/3049), [3050](https://github.com/egovernments/egov-mdms-data/pull/3050), [3052](https://github.com/egovernments/egov-mdms-data/pull/3052), [3053](https://github.com/egovernments/egov-mdms-data/pull/3053), [3055](https://github.com/egovernments/egov-mdms-data/pull/3055), [3075](https://github.com/egovernments/egov-mdms-data/pull/3075) |                            |

## **Config Changes**

| Feature                                 | Service Name | Changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Description                |
| --------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
|                                         |              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | DIGIT 2.9 release changes. |
| Citizen Feedback & Citizen consent form |              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                            |
| DSS                                     |              | [2587](https://github.com/egovernments/configs/pull/2587) , [2590](https://github.com/egovernments/configs/pull/2590) , [2593](https://github.com/egovernments/configs/pull/2593) , [2596](https://github.com/egovernments/configs/pull/2596) , [2599](https://github.com/egovernments/configs/pull/2599) , [2600](https://github.com/egovernments/configs/pull/2600) , [2602](https://github.com/egovernments/configs/pull/2602) , [2603](https://github.com/egovernments/configs/pull/2603) , [2605](https://github.com/egovernments/configs/pull/2605) , [2607](https://github.com/egovernments/configs/pull/2607) , [2610](https://github.com/egovernments/configs/pull/2610) , [2611](https://github.com/egovernments/configs/pull/2611) , [2612](https://github.com/egovernments/configs/pull/2612) , [2628](https://github.com/egovernments/configs/pull/2628) , [2629](https://github.com/egovernments/configs/pull/2629) , [2631](https://github.com/egovernments/configs/pull/2631) , [2633](https://github.com/egovernments/configs/pull/2633), [2637](https://github.com/egovernments/configs/pull/2637), [2641](https://github.com/egovernments/configs/pull/2641), [2646](https://github.com/egovernments/configs/pull/2646), [2649](https://github.com/egovernments/configs/pull/2649) | <p> </p><p> </p><p> </p>   |
| mCollect Pdf - QR Code Bug Fix          |              | [2646](https://github.com/egovernments/configs/pull/2646)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                            |
| Internal Gateway Config                 |              | [<img src="https://github.githubassets.com/favicon.ico" alt="" data-size="line">internal-gateway.json](https://github.com/egovernments/configs/blob/central-instance/internal-gateway.json)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | DIGIT 2.9 release changes. |

## **DevOps Changes**

<table><thead><tr><th width="131">Feature</th><th width="179">Service Name</th><th>Changes</th><th>Description</th></tr></thead><tbody><tr><td> </td><td> </td><td> </td><td>DIGIT 2.9 release changes.</td></tr><tr><td>DSS</td><td> </td><td><a href="https://github.com/egovernments/DIGIT-DevOps/pull/1332">1332</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1333">1333</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1334">1334</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1335">1335</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1336">1336</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1432">1432</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1458">1458</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1466">1466</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1487">1487</a>, <a href="https://github.com/egovernments/DIGIT-DevOps/pull/1487">1487</a></td><td> </td></tr></tbody></table>


# Service Build Updates

Service build details for 2.9 Release

## S**ervice Builds 2.9**&#x20;

| Category                                                                                                  | Services                            | Docker Artefact ID                                       | Remarks   |
| --------------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------- | --------- |
| **Frontend (old UI)** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9/frontend/mono-ui)    | Citizen                             | citizen:v1.10.0-beta-90968a5987-33                       |           |
|                                                                                                           | Employee                            | employee:v1.10.0-beta-90968a5987-45                      |           |
|                                                                                                           | DSS Dashboard                       | dss-dashboard:v1.10.0-beta-0ad561e837-4                  | unchanged |
| **Digit-UI** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9/frontend/micro-ui)            | DIGIT UI                            | digit-ui:v1.7.0-beta.2-6e3654830c-511                    |           |
| **Core Services** [**v2.9**](https://github.com/egovernments/Digit-Core/releases/tag/urban_v2.9)          | Service-request                     | service-request:v1.0.0\_beta-cddd1fb55c-12               | unchanged |
|                                                                                                           | Signed Audit                        | audit-service:v1.0.0-24873ba-3                           | unchanged |
|                                                                                                           | Encryption                          | egov-enc-service:v1.1.4-1f3649156d-5                     |           |
|                                                                                                           | xState Chatbot                      | xstate-chatbot:v1.1.1-44558a0602-1                       |           |
|                                                                                                           | Searcher                            | egov-searcher:v1.1.6-bc771ff4d4-6                        |           |
|                                                                                                           | Payment Gateway                     | egov-pg-service:v1.2.3-ffbb7a6-2                         |           |
|                                                                                                           | Filestore                           | egov-filestore:v1.2.4-9934605-2                          |           |
|                                                                                                           | Zuul - API Gateway                  | zuul:v1.3.1-76bf31f-2                                    |           |
|                                                                                                           | Mail Notification                   | egov-notification-mail:v1.2.0-9fde481c92-1               |           |
|                                                                                                           | SMS Notification                    | egov-notification-sms:v1.2.0-9fde481c92-2                |           |
|                                                                                                           | Localization                        | egov-localization:v1.1.3-44558a0602-2                    |           |
|                                                                                                           | Persist                             | egov-persister:v1.1.6-1f3649156d-3                       |           |
|                                                                                                           | ID Gen                              | egov-idgen:v1.2.3-44558a0602-2                           |           |
|                                                                                                           | User                                | egov-user:v1.2.8-9fde481c92-2                            |           |
|                                                                                                           | User Chatbot                        | egov-user-chatbot:v1.2.8-9fde481c92-2                    |           |
|                                                                                                           | MDMS                                | egov-mdms-service:v1.3.3-1f3649156d-4                    |           |
|                                                                                                           | URL Shortening                      | egov-url-shortening:v1.1.2-010cd85ad6-3                  |           |
|                                                                                                           | Indexer                             | egov-indexer:v1.1.8-36a0a061fd-34                        |           |
|                                                                                                           | Report                              | report:v1.3.6-3ad63f2273-4                               |           |
|                                                                                                           | Workflow                            | egov-workflow-v2:v1.3.1-1f3649156d-5                     |           |
|                                                                                                           | PDF Generator                       | pdf-service-db:v1.2.2-5d71b59949-18                      |           |
|                                                                                                           | Chatbot                             | chatbot:v1.1.6-44558a0602-1                              |           |
|                                                                                                           | Access Control                      | egov-accesscontrol:v1.1.3-852f5ea3a0-3                   |           |
|                                                                                                           | Location                            | egov-location:v1.1.5-fbea79700d-1                        |           |
|                                                                                                           | OTP                                 | egov-otp:v1.2.3-9fde481c92-1                             |           |
|                                                                                                           | User OTP                            | user-otp:v1.2.1-1f3649156d-2                             |           |
|                                                                                                           | NLP Engine                          | nlp-engine:v1.0.0-fbea6fba-21                            | unchanged |
|                                                                                                           | Egov Document-Uploader              | egov-document-uploader:v1.0.1-a1ef7d4187-1               |           |
|                                                                                                           | National Dashboard Ingest           | national-dashboard-ingest:v1.0.1-44558a0-4               |           |
|                                                                                                           | National Dashboard Kafka Pipeline   | national-dashboard-kafka-pipeline:v1.0.1-44558a0-4       |           |
|                                                                                                           | Egov Survey Service                 | egov-survey-services:v0.0.1-a9d54c2543-25                | unchanged |
|                                                                                                           | Internal Gateway                    | internal-gateway:v0.0.1-44558a0-3                        |           |
| **Business Services** [**v2.9**](https://github.com/egovernments/Digit-Core/releases/tag/urban_v2.9)      | Apportion                           | egov-apportion-service:v1.1.5-44558a0602-1               |           |
|                                                                                                           | Collection                          | collection-services:v1.1.6-855dc9a-2                     |           |
|                                                                                                           | Billing                             | billing-service-db:v1.3.5-a4d411ecd0-16                  |           |
|                                                                                                           | HRMS                                | egov-hrms:v1.2.7-bc771ff4d4-4                            |           |
|                                                                                                           | Dashboard Analytics                 | dashboard-analytics:v1.1.9-aea1817792-10                 |           |
|                                                                                                           | Dashboard Ingest                    | national-dashboard-ingest:v1.0.1-44558a0-4               |           |
|                                                                                                           | EGF Instrument                      | egf-instrument:v1.1.4-d93a120c25-2                       | unchanged |
|                                                                                                           | EGF Master                          | egf-master:v1.1.3-d93a120c25-2                           | unchanged |
|                                                                                                           | Finance Collection Voucher Consumer | finance-collections-voucher-consumer:v1.1.6-d93a120c25-4 |           |
| **Municipal Services** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9/municipal-services) | Trade License                       | tl-services:v1.1.9-a7462eff5a-7                          |           |
|                                                                                                           | Trade License Calculator            | tl-calculator:v1.1.6-3ad63f2273-4                        |           |
|                                                                                                           | Fire NOC                            | firenoc-services-db:v1.3.3-4550d93cde-34                 |           |
|                                                                                                           | Fire NOC Calculator                 | firenoc-calculator:v1.2.3-3ad63f2273-13                  |           |
|                                                                                                           | Property Services                   | property-services:v1.2.2-a7462eff5a-57                   |           |
|                                                                                                           | Property Tax Calculator             | pt-calculator-v2:v1.1.6-3ad63f2273-10                    |           |
|                                                                                                           | Property Tax                        | property-services:v1.2.2-8566918dfc-66                   |           |
|                                                                                                           | Water Charges                       | ws-services:v1.7.5-a7462eff5a-20                         |           |
|                                                                                                           | Water Charges Calculator            | ws-calculator:v1.4.4-3ad63f2273-13                       |           |
|                                                                                                           | Sewerage Charges                    | sw-services:v1.7.5-a7462eff5a-14                         |           |
|                                                                                                           | Sewerage Charges Calculator         | sw-calculator:v1.4.4-a7462eff5a-18                       |           |
|                                                                                                           | BPA Calculator                      | bpa-calculator:v1.1.2-3ad63f2273-7                       |           |
|                                                                                                           | BPA Services                        | bpa-services:v1.1.7-a7462eff5a-18                        |           |
|                                                                                                           | User Event                          | egov-user-event:v1.2.0\_beta-97005a72ec-3                |           |
|                                                                                                           | PGR                                 | rainmaker-pgr:v1.1.4\_beta-e3769f2e9f-1                  |           |
|                                                                                                           | PGR Service                         | pgr-services:v1.1.8-3ad63f2273-7                         |           |
|                                                                                                           | Land Services                       | land-services:v1.0.5-3ad63f2273-6                        |           |
|                                                                                                           | NOC Services                        | noc-services:v1.0.6-3ad63f2273-11                        |           |
|                                                                                                           | FSM                                 | fsm:v1.2.0-98a12c2748-224                                | unchanged |
|                                                                                                           | FSM Calculator                      | fsm-calculator:v1.1.0-32caf0d992-41                      | unchanged |
|                                                                                                           | Vehicle                             | vehicle:v1.2.0-180a328097-97                             | unchanged |
|                                                                                                           | Vendor                              | vendor:v1.2.0-a28b192446-64                              | unchanged |
|                                                                                                           | eChallan Services                   | echallan-services:v1.1.1-a7462eff5a-14                   |           |
|                                                                                                           | eChallan Calculator                 | echallan-calculator:v1.0.3-3ad63f2273-5                  |           |
|                                                                                                           | Inbox                               | inbox:v1.3.1-1f3649156d-10                               |           |
|                                                                                                           | Turn-IO                             | turn-io-adapter:v1.0.1-3d7f744977-4                      |           |
|                                                                                                           | Birth and Death Services            | birth-death-services-db:v1.0.2-d43fa051aa-41             |           |
| **Utilities Services** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9/utilities)          | Custom Consumer                     | egov-custom-consumer:v1.1.1-d93a120c25-2                 |           |
|                                                                                                           | PDF                                 | egov-pdf:v1.2.1-cb236eaf66-8                             |           |
| **eDCR** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9-beta/edcr)                        | eDCR                                | egov-edcr:v2.1.2-bdebd6c5c1-26                           |           |
| **Finance** [**v2.9**](https://github.com/egovernments/DIGIT-OSS/tree/v2.9/finance)                       | Finance                             | egov-finance:v3.0.2-3c708604d0-1                         |           |
| **Configs Stateb** [**v2.9**](https://github.com/egovernments/configs/releases/tag/urban_v2.9)            |                                     |                                                          |           |
| **Configs Central** [**v2.9**](https://github.com/egovernments/configs/releases/tag/urban_v2.9)           |                                     |                                                          |           |
| **MDMS StateB** [**v2.9**](https://github.com/egovernments/MDMS-TenantB/releases/tag/v2.9)                |                                     |                                                          | unchanged |
| **MDMS Central** [**v2.9**](https://github.com/egovernments/egov-mdms-data/releases/tag/v2.9)             |                                     |                                                          | unchanged |
| **DevOps StateB** [**v.2.9**](https://github.com/egovernments/stateB-DevOps/releases/tag/v2.9)            |                                     |                                                          |           |
| **DevOps Central** [**v.2.9**](https://github.com/egovernments/DIGIT-DevOps/releases/tag/v2.9)            |                                     |                                                          |           |
| **Localization** [**v2.9**](https://github.com/egovernments/releasekit/releases/tag/v2.9)                 |                                     |                                                          | unchanged |
| **QA Automation** [**v2.9**](https://github.com/egovernments/test-automation/releases/tag/v2.8)           |                                     |                                                          | unchanged |

&#x20;


# Test Cases

DIGIT 2.9 Release Test Cases

## **National Dashboard New KPIs**

{% embed url="<https://docs.google.com/spreadsheets/d/e/2PACX-1vSbqS9NqQ2S3fxtWetadqhXJRY3wVIQEd5hkpGfkPfACEAXg3FqxFyB-OZpc4yhGUi6zZk7V3awwqI7/pubhtml>" %}

## **Citizen Feedback**

{% embed url="<https://docs.google.com/spreadsheets/d/e/2PACX-1vSKILlLWycvq8A2IwiiQN1nAdVYnq6wrH-2sFGRyEwY04tEVhsEsIulHj6sK4nDwGIj5OPKUVhCZZSB/pubhtml>" %}

## **Citizen Consent Form**

{% embed url="<https://docs.google.com/spreadsheets/d/e/2PACX-1vSs_JgAyWcdpyZmE5rNnnNp9qCTGpaPCb8XOqWp9_vd4J4XXQ38eyhyLAKIVF2RQQqf34kUYe9WgIIv/pubhtml>" %}

## **Central Instance**

No additional test cases have been added for the central instance. The existing test cases should work for the central instance as is.


# Gate 2 Release Checklist

DIGIT 2.9 Gate 2 Release Checklist

<table><thead><tr><th width="97">S.No.</th><th width="162">Checklist</th><th>Yes/No/Partially</th><th width="158">Reference Link</th><th>Owner</th><th width="103">Reviewer</th><th width="296">Remarks</th></tr></thead><tbody><tr><td>1</td><td>Development is completed for all the features that are part of the release.</td><td>Yes</td><td> </td><td>@Kaviyarasan P</td><td>@Kaviyarasan P</td><td>Code is frozen by APR-2023</td></tr><tr><td>2</td><td>Test cases are documented by the QA team, and reviewed by the product owners and test results are updated in the test cases sheet.</td><td>Yes</td><td><p><a href="/pages/-MgiGQw6nxAyGaQhr_so">Test Cases for Release Digit 2.9</a></p><p></p></td><td><p>@Gurjeet Singh</p><p> </p></td><td>@Priyanka Samantaroy</td><td>No new test cases for central instance are there. All existing test cases should work as is.</td></tr><tr><td>3</td><td>The incremental demo of the features showcased during the sprint showcase and feedback incorporated. If possible list out the JIRA tickets for feedback.</td><td>Yes</td><td> <a href="https://drive.google.com/file/d/1SCcOFd4oj1xneNP5aNT-_6DYK_yCEOqN/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs).mp4</a><br><a href="https://drive.google.com/file/d/1NQ8CHp4M10MEGTKywywMhfawXyLJFZAa/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs)_1.mp4</a><br><a href="https://digit-discuss.atlassian.net/issues/?jql=project%20%3D%20UM%20AND%20labels%20%3D%202.9_improvement%20ORDER%20BY%20created%20DESC">Jira tickets for feedback</a></td><td>@Kaviyarasan P</td><td> </td><td>Demo given on 18-APR-2023 for Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs.<br><br>Central Instance - No demo required.</td></tr><tr><td>4</td><td>UI/UX Audit review by UX Architect is completed along with feedback incorporation for any changes in UI/UX.</td><td>Yes</td><td><a href="https://drive.google.com/file/d/1l6XdxYZFMQEr_-ZZzFNWB77flAxmr-hd/view"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">2.9-DesignReview.mp4</a></td><td><p>@Andrew Jones</p><p>@Vamshikrishna Kole</p></td><td> </td><td>UI/UX audit is done and review comments are incorporated.</td></tr><tr><td>5</td><td>Incremental demos to the product owners are completed as part of the sprint and feedbacks are incorporated.</td><td>Yes</td><td><a href="https://drive.google.com/file/d/1SCcOFd4oj1xneNP5aNT-_6DYK_yCEOqN/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs).mp4</a><br><a href="https://drive.google.com/file/d/1NQ8CHp4M10MEGTKywywMhfawXyLJFZAa/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs)_1.mp4</a></td><td>@Megha S<br>@P. Sankar</td><td>@P. Sankar</td><td>Demo given on 18-APR-2023 for Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs.<br><br>Central Instance - No demo required.</td></tr><tr><td>6</td><td>QA signoff is completed by the QA team and communicated to the product owners. All the tickets QA signoff status is updated in the JIRA.</td><td>Yes</td><td><a href="/pages/-MgiGQw6nxAyGaQhr_so">Test Cases for Release Digit 2.9</a></td><td><p>@Gurjeet Singh</p><p> </p></td><td> </td><td>QA signoff was completed.<br>Sign-off dates<br>14th April 2023<br>Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs<br><br>Central Instance - <br>15th September 2023</td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>7</td><td>UI, API Technical documents are updated for the release along with the configuration documents. </td><td>Yes</td><td><a href="/pages/dBgiyen7HQVkK89p8s3T">UI documentation</a> for central instance</td><td><p>@Kaviyarasan P</p><p>@Vamshikrishna Kole</p></td><td> </td><td> </td></tr><tr><td>8</td><td>UAT promotion and regression testing from the QA team is completed. QA team has shared the UAT regression test cases with the product owners.</td><td>Yes</td><td><p><a href="/pages/-MgiGQw6nxAyGaQhr_so">Test Cases for Release Digit 2.9</a></p><p></p></td><td><p>@Gurjeet Singh</p><p> </p></td><td><p> </p><p> </p></td><td>No new test cases for central instance are there. All existing test cases should work as is.</td></tr><tr><td>9</td><td>API Automation scripts are updated for new APIs or changes to any existing APIs for the release. API automation regression is completed on UAT, the automation test results are analyzed and necessary actions are taken to fix the failure cases. Publish the list of failure use cases with a reason for failure and the resolution taken to fix these failures for the release.</td><td>No</td><td></td><td><p>@Gurjeet Singh</p><p></p></td><td> </td><td><p> </p><p>Not picked up in this release due to lack of resources. We do not have QA resource who can write automation scripts.</p></td></tr><tr><td>10</td><td>The API backward compatibility testing is completed.</td><td>Yes</td><td><a href="https://docs.google.com/spreadsheets/d/e/2PACX-1vSrDy9D8SxUAG8FzyS_7-P1CxzVGmhf6GTUW0DtxyAAm1dLP1P4lzRlPQAz_dSMtE9Gma_IhArGKGFm/pubhtml">Backward Compatibilty Report</a></td><td>@Gurjeet Singh</td><td>@Kaviyarasan P</td><td>Tested on 25-AUG-2023</td></tr><tr><td>11</td><td>The communication is shared with the product owners for the completion of UAT promotion and regression by the QA team. The product owners have to give a Product signoff within one week of this communication.</td><td>Yes</td><td></td><td><p>@Gurjeet Singh</p><p>@KeerthiBhaskara-eGov</p><p> </p></td><td> @Megha S</td><td><p>UAT signoff was completed.<br>Sign-off dates<br>14th April 2023<br>Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs</p><p> </p><p></p><p>Central Instance- No communication required</p><p> </p></td></tr><tr><td>12</td><td>UAT Product Signoff communication is received from the Product owners along with the release notes and User guides (if applicable).</td><td>Yes</td><td><p><a href="/pages/-MgiGQw4bSzZjl0DdQEr">Release Notes </a></p><p><br><a href="/pages/rABUiwY24JnTcfyR8J0l">DIGIT SAAS Guideline - Central Instance</a><br></p></td><td> @Megha S</td><td> @P. Sankar</td><td><p>UAT product signoff for Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs</p><p>given on 19th April 2023</p><p></p><p>Central Instance - UAT product signoff not needed. Central Instance is a separate environment</p></td></tr><tr><td>13</td><td>The GIT tags and releases are created for the code changes for the release.</td><td>Yes</td><td><a href="/pages/-MgiGQw50wYl9uAc29te">Service Build Updates</a></td><td>@Priyanka Samantaroy</td><td> @Kaviyarasan P</td><td> </td></tr><tr><td>14</td><td>Verify whether the Release notes are updated</td><td>Yes</td><td><p><a href="/pages/-MgiGQw4bSzZjl0DdQEr">Release Notes </a></p><p><br><a href="/pages/rABUiwY24JnTcfyR8J0l">DIGIT SAAS Guideline - Central Instance</a><br></p></td><td>@Priyanka Samantaroy</td><td> @Kaviyarasan P</td><td> </td></tr><tr><td>15</td><td>Verify whether all UAT Builds are updated along with the GIT tag details.</td><td>Yes</td><td><a href="/pages/-MgiGQw50wYl9uAc29te">Service Build Updates</a></td><td>@Priyanka Samantaroy</td><td> @Kaviyarasan P</td><td> </td></tr><tr><td>16</td><td>Verify whether all MDMS, Configs, InfraOps configs updated.</td><td>Yes</td><td><a href="/pages/tnw68LGT2ZW9vdriDstg">MDMS, Configurations</a></td><td>@Priyanka Samantaroy</td><td>@Kaviyarasan P</td><td> </td></tr><tr><td>17</td><td>Verify whether all docs will be Published to <a href="http://urban.digit.org/">http://urban.digit.org</a> by the Technical Writer as part of the release.</td><td>Yes</td><td> </td><td><p>@Kaviyarasan P,</p><p>@Pradeep Kumar,</p><p>@Ajay Rawat, @Megha S</p><p></p></td><td>@Anjoo Narayan</td><td> </td></tr><tr><td>18</td><td>Verify whether all test cases are up to date and updated along with necessary permissions to view the test cases sheet. The test cases sheet is verified by the Test Lead.</td><td>Yes</td><td><p><a href="/pages/-MgiGQw6nxAyGaQhr_so">Test Cases 2.9</a></p><p></p></td><td><p>@Gurjeet Singh</p><p> </p></td><td> </td><td>No new test cases for central instance are there. All existing test cases should work as is.</td></tr><tr><td>19</td><td>Verify whether the UAT credentials sheet is updated with the details of new Users and Roles if any</td><td>Yes</td><td><p><a href="https://docs.google.com/spreadsheets/d/15p6dmlVUXvopvzyyG06ty2rxtffSMQxN5F2l2FSWoFA/edit#gid=1583984676">https://docs.google.com/spreadsheets/d/15p6dmlVUXvopvzyyG06ty2rxtffSMQxN5F2l2FSWoFA/edit#gid=1583984676</a></p><p><a href="https://docs.google.com/spreadsheets/d/1H5LeWJpTomV6u-w4p6e_pIBsK0oPp-V9qclPHwycpq4/edit#gid=1333741507">https://docs.google.com/spreadsheets/d/1H5LeWJpTomV6u-w4p6e_pIBsK0oPp-V9qclPHwycpq4/edit#gid=1333741507</a></p></td><td>@Gurjeet Singh</td><td> </td><td><p>No new credentials required for -<br>Citizen Feedback<br>Citizen Consent form<br>DSS New KPIs</p><p>New credential for Central Instance Attached</p><p> </p></td></tr><tr><td>20</td><td>Verify whether all the localization data was added in UAT including Hindi and updated in Release Kits.</td><td>Yes</td><td><p><a href="https://github.com/egovernments/releasekit/releases/tag/v2.9">Localization</a> </p><p></p></td><td>@Priyanka Samantaroy</td><td>@Kaviyarasan P</td><td>No new localization added for the central instance</td></tr><tr><td>21</td><td>Verify whether the product release notes and user guides are updated and published</td><td>Yes</td><td><p><a href="/pages/IO2eSAMnVa1bfs69ZZDZ">User Guides link<br>Citizen consent  </a><br><a href="/pages/eLHvfIIbZqTVzZqCcYoS">Citizen feedback</a> <br></p><p><a href="/pages/-MgiGQw4bSzZjl0DdQEr"><strong>Release Notes DIGIT 2.9</strong></a></p></td><td>Product Owners</td><td> </td><td> </td></tr><tr><td>22</td><td>The Demo of released features is done by the product team as part of the Sprint/Release showcase.</td><td>Yes</td><td><a href="https://drive.google.com/file/d/1SCcOFd4oj1xneNP5aNT-_6DYK_yCEOqN/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs).mp4</a><br><a href="https://drive.google.com/file/d/1NQ8CHp4M10MEGTKywywMhfawXyLJFZAa/view?usp=sharing"><img src="https://developers.google.com/drive/images/drive_icon.png" alt="" data-size="line">Demo (Citizen Feedback, Consent and DSS KPIs)_1.mp4</a></td><td> </td><td> </td><td>Demo given on 18-APR-2023 for Citizen Feedback<br>Citizen Consent Form<br>DSS New KPIs.<br><br>Central Instance - No demo required.</td></tr><tr><td>23</td><td>Technical and Product workshops/demos are conducted by the Engineering and Product team to the implementation team (Implementation handover)</td><td>Yes</td><td><a href="/pages/rABUiwY24JnTcfyR8J0l">DIGIT SAAS Guideline - Central Instance</a></td><td>@Kaviyarasan P</td><td>@Kaviyarasan P</td><td> Technical and Product workshops/demo conducted on 23-July-2023</td></tr><tr><td>24</td><td>Architect SignOff and Technical Quality Report</td><td>Yes</td><td> </td><td>@Kaviyarasan P</td><td>@Ghanshyam Rawat</td><td> Signed off by @Kaviyarasan P on 31-July-2023</td></tr><tr><td>25</td><td>Success Metrics and Product Roadmap</td><td>Yes</td><td><a href="/pages/DDdiRNS1d7ZTTENEd3Hg">Program Roll Out Plan</a></td><td> @Ajay Rawat</td><td> </td><td> </td></tr><tr><td>26</td><td>Adoption Metrics</td><td>Yes</td><td> <a href="/pages/DDdiRNS1d7ZTTENEd3Hg">Program Roll Out Plan</a></td><td><p>@Ajay Rawat<br><br></p><p> </p></td><td> </td><td> </td></tr><tr><td>27</td><td>Program Roll-out Plan</td><td>Yes</td><td> <a href="/pages/DDdiRNS1d7ZTTENEd3Hg">Program Roll Out Plan</a></td><td>@Ajay Rawat</td><td>@Pradeep Kumar</td><td> </td></tr><tr><td>28</td><td>Implementation checklist</td><td>Yes</td><td> <a href="/pages/Nzl3Zv5yliLaaE6WLqNm">Implementation Checklist</a></td><td>@Pradeep Kumar/@Vinoth</td><td> </td><td>Prepared.</td></tr><tr><td>29</td><td>Implementation Roll-out plan</td><td>Yes</td><td><a href="https://docs.google.com/spreadsheets/d/1iY7QLNdatz2wzcgJH73C6Iiq9bej1Z_7z7FxtETKVyg/edit#gid=1619110608"> Roll-out Plan</a></td><td>@Pradeep Kumar/@Vinoth</td><td> </td><td> </td></tr><tr><td>30</td><td>Gate 2</td><td>Yes</td><td><a href="https://docs.google.com/presentation/d/192ZN4Se1kwGoEwiFBUmHL90gbZr0aTbROOWjTxVXqH8/edit?usp=sharing"> DIGIT Urban Gate 2</a></td><td>@Ajay Rawat</td><td> </td><td> </td></tr><tr><td>31</td><td>The Internal release communication along with all the release artefacts are shared by the Engineering/Product team.</td><td>Yes</td><td> <a href="/pages/-MgiGQw4bSzZjl0DdQEr">Release Notes DIGIT 2.9</a></td><td> @Priyanka Samantaroy</td><td> @Kaviyarasan P</td><td> </td></tr><tr><td>32</td><td>Plan for upgrading the staging/demo instance with the release product - within 2-4 weeks based on the period where no demos are planned from staging for the previous version of the released product.</td><td>Yes</td><td> <a href="https://docs.google.com/spreadsheets/d/1iY7QLNdatz2wzcgJH73C6Iiq9bej1Z_7z7FxtETKVyg/edit#gid=1619110608">Staging Upgrade</a></td><td>@Pradeep Kumar/@Vinoth</td><td> </td><td> </td></tr><tr><td>33</td><td>The Release communication to partners is shared by the GTM team and the Webinar is arranged by the GTM team after the release communication - within 2-4 weeks of the release.</td><td>No</td><td> </td><td> </td><td> </td><td><p> </p><p> </p></td></tr></tbody></table>

<br>


# Implementation Checklist

<table data-header-hidden><thead><tr><th width="95"></th><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>@Sl No</strong></td><td><strong>Checklist</strong></td><td><strong>Yes/No/Partially</strong></td><td><strong>Reference link</strong></td><td><strong>Owner</strong></td><td><strong>Date(mm/dd/yyyy)</strong></td><td><strong>Remarks</strong></td></tr><tr><td>1</td><td>Product Release Notes</td><td>Yes</td><td><a href="/pages/-MgiGQw4bSzZjl0DdQEr">Release Notes</a></td><td>Kavi</td><td> </td><td></td></tr><tr><td>2</td><td>List of services that needs to be upgraded</td><td>Yes</td><td><a href="/pages/-MgiGQw50wYl9uAc29te">Service Build Updates</a></td><td>Kavi/Priyanka</td><td> </td><td>Verified.</td></tr><tr><td>3</td><td>Verify Configs, MDMS, devOps Changes</td><td>Yes</td><td> <a href="/pages/tnw68LGT2ZW9vdriDstg">Mdms &#x26; Config updates 2.9</a></td><td>Pradeep/Vinoth</td><td> </td><td>Verified</td></tr><tr><td>4</td><td>Verify test cases for all enhancements/updates</td><td>Yes</td><td> <a href="/pages/-MgiGQw6nxAyGaQhr_so">Test cases for 2.9</a></td><td>Gurjeet</td><td> </td><td></td></tr><tr><td>5</td><td>Verify performance testing report</td><td></td><td> </td><td>Gurjeet</td><td> </td><td>No report found</td></tr><tr><td>6</td><td>Verify backward compatibility testing report</td><td>Yes</td><td> <a href="https://digit-discuss.atlassian.net/browse/UM-6454">Backward Compatibility Testing report</a></td><td>Gurjeet</td><td> </td><td></td></tr><tr><td>7</td><td>Verify the documents for released features</td><td>Yes</td><td><a href="https://docs.google.com/document/d/1ji21H-PZZBENKUoYW4KLte8Jad3SqMJZudCmmNyp4Rg/edit">Clarifications</a></td><td>Pradeep/Vinoth</td><td> </td><td></td></tr><tr><td>8</td><td>Backward compatibility testing by disabling central instance flag on existing environment</td><td>Yes</td><td><a href="https://digit-discuss.atlassian.net/browse/UM-6487">Backward compatibility testing by disabling central instance flag</a></td><td>Vinoth/Gurjeet</td><td> </td><td>Verified the backward compatibility in UAT environment by disabling the flag and deploying latest builds.</td></tr><tr><td>9</td><td>Setup fresh central instance from scratch for two states and verify</td><td>Yes</td><td> <a href="https://docs.google.com/spreadsheets/d/1O72hhFcyJvePR7_8jyekkpP2YLN-2m2pY0K_5nou4i0/edit#gid=1206146090">Setup fresh central instance and verify</a></td><td>Vinoth</td><td> </td><td> Verified documents and updated missing gaps in the document.</td></tr><tr><td>10</td><td>Impel-Singoff</td><td>Yes</td><td><a href="https://digit-discuss.atlassian.net/browse/UM-6521">Signoff</a></td><td>Vinoth/Gurjeet</td><td> 15/09/2023</td><td> Verified</td></tr><tr><td>11</td><td>Technical discussion on central instance with Partners</td><td>Yes</td><td> <a href="https://tldv.io/app/meetings/64c7817b6c2ae4001356dea6">discussion and demo</a></td><td>Vinoth/Pradeep</td><td> 31/07/2023</td><td>Technical Discussion with NIUA and PWC team done on 31st July '23.</td></tr><tr><td>12</td><td>Demo on Release features to partners</td><td> Yes</td><td> </td><td>Vinoth/Pradeep</td><td> 18/05/2023</td><td>Demo Provided 18th May 2023 to Impel partners.</td></tr><tr><td>13</td><td>Staging upgradation plan</td><td>Yes</td><td> <a href="https://docs.google.com/spreadsheets/d/1iY7QLNdatz2wzcgJH73C6Iiq9bej1Z_7z7FxtETKVyg/edit#gid=1619110608">Staging Upgrade</a></td><td>Vinoth</td><td> </td><td> </td></tr><tr><td>14</td><td>Deployment strategy for DIGIT 2.9</td><td>Yes</td><td> <a href="https://docs.google.com/spreadsheets/d/1iY7QLNdatz2wzcgJH73C6Iiq9bej1Z_7z7FxtETKVyg/edit#gid=204510096">Deployment strategy for DIGIT 2.9</a></td><td>NIUA Team /Ajay</td><td> </td><td> </td></tr><tr><td>15</td><td>Address queries raised by partner on central instance</td><td>No</td><td> Queries raised by NIUA to be addressed post Gate 2 as additional effort is required.</td><td>NIUA Team /Ajay</td><td> </td><td> </td></tr></tbody></table>

<br>


# Program Roll Out Plan

DIGIT Urban 2.9 release has a new following features:

* DIGIT Urban 2.9 Beta Features
* DIGIT as a Service
* Bug Fixes

| Task                                                                     | Status      | Owner         |
| ------------------------------------------------------------------------ | ----------- | ------------- |
| Upgrade of UPYOG with Beta features                                      | 15/05/2023  | Pradeep Kumar |
| Session with NUDM team on Central Instance                               | 31/07/2023  | Ajay Rawat    |
| Getting approval from partners for UPYOG upgrade with DIGIT as a Service | In Progress | Ajay Rawat    |
| Effort Estimate for Upgrade created                                      | Done        | Vinoth        |
| Gate 2                                                                   | In Progress | Ajay Rawat    |
| Release Communication Shared with Partners                               | To Do       | Ajay Rawat    |

### NUDM Roll Out <a href="#nudm-roll-out" id="nudm-roll-out"></a>

The NUDM Team has shared the following requirements for upgrading UPYOG with the Central Instance:

**\*Conditions for Upgrading UPYOG with Central Instance**

* Role & Access Management at Cluster Level so that each State SI can do its scope of work
* Role & Access Management at Logs Level  so that each State SI can do its scope of work
* Role & Access Management at Elastic Search & Kibana Level  so that each State SI can do its scope of work
* Enhancement & verification of Product default Kafka with more nodes, partitions, etc so that it sustains and performs for National Level traffic
* Enhancement & verification of Product default ElasticSearch with more nodes, shards, etc so that it sustains and performs for National Level traffic
* Availability of all States data in its DB schemas and the same should apply with ElasticSearch
* Other enhancements so that the State Infra & DevOps team can manage their resources independently.

## **Adoption Metrics**

| Feature            | Metric                                                                  | Estimate                                                                                                                                               |
| ------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Citizen Feedback   | No. of states adopting feature and sharing data with National Dashboard | At least 2 states to implement the feature under NUDM in next 6 months                                                                                 |
| Consent form       | Compliance to NUIS Assessment                                           | Compliance report already shared post release of feature                                                                                               |
| Dashboard KPIs     | No. of states sharing data on new KPIs                                  | Citizen Feedback feature to be implemented in states, for KPIs to start reflecting data. 2+ states to implement the feature and share data on the KPIs |
| DIGIT as a Service | No. of accounts/projects using feature in all missions                  | At least 2 accounts use DIGIT as a Service in next 6 months                                                                                            |

## Success Metrics

| Feature            | Objective                                      | Estimate                                                                  |
| ------------------ | ---------------------------------------------- | ------------------------------------------------------------------------- |
| Citizen Feedback   | Improvement in Citizen Satisfaction            | Improvement in Metrics by 20% in first 3 years in state using the feature |
| Consent form       | Compliance to NUIS Assessment                  | Compliance report already shared post release of feature                  |
| Dashboard KPIs     | Improvement in Citizen Satisfaction            | Improvement in Metrics by 20% in first 3 years in state using the KPIs    |
| DIGIT as a Service | Optimizing resources for saving in infra costs | Saving to be estimated                                                    |


# Product Release Notes


# Property Tax System Release Notes

## Overview <a href="#overview" id="overview"></a>

This release provides PRDs of 3 property tax features and a few bug fixes.

## Release Highlights <a href="#release-highlights" id="release-highlights"></a>

PRDs of 3 property tax features and bug fixes.

1. [Properties amalgamation](/local-governance/access/local-governance-stack/property-tax/property-tax-system-product-requirements-document/property-amalgamation)
2. [Property bifurcation](/local-governance/access/local-governance-stack/property-tax/property-tax-system-product-requirements-document/property-bifurcation)
3. [Capital value system](/local-governance/access/local-governance-stack/property-tax/property-tax-system-product-requirements-document/capital-value-system)
4. Property mutation bug fixes

## Release Features <a href="#release-features" id="release-features"></a>

None

## Known Issues <a href="#known-issues" id="known-issues"></a>

Bug

[![](https://digit-discuss.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10303?size=medium)UM-5322: PT: Mutation flow: In Acknowledgement Form only one Transferor Details are present.SIGNED OFF](https://digit-discuss.atlassian.net/browse/UM-5322)

## Upcoming Release Features

None

## Reference Doc Links <a href="#reference-doc-links" id="reference-doc-links"></a>

|   |   |
| - | - |
|   |   |
|   |   |

&#x20;<br>


# Residential Construction Permit System UI/UX Revamp Release Notes

OBPS Release notes for Urban DIGIT 2.8 release.

## Overview <a href="#overview" id="overview"></a>

This release offers the UI/UX revamp of the Residential Construction Permit System, workflow timeline changes and reports.

## Release Highlights <a href="#release-highlights" id="release-highlights"></a>

The functionality in OBPS remains the same - only the UI/UX has changed.

Two reports were added for administrative purposes.

Changes made to the workflow timeline for clear representation of application status to the users.

Notification based on channels.

## Release Features <a href="#release-features" id="release-features"></a>

* Stakeholder registration and employee approval flow
* Architect flow (permit application creation) and employee approval flow
* Architect occupancy certificate creation and employee approval flow
* Fire NOC employee approval flow
* Open link for stakeholder registration flow
* Daily collection report

<figure><img src="/files/boIN6fpasU7X4ej1ZKr4" alt=""><figcaption><p>OBPS daily collection report</p></figcaption></figure>

Residential construction permit application status report

<figure><img src="/files/DN5bIFJmJNXkOrhmjZZb" alt=""><figcaption><p>OBPS application status report</p></figcaption></figure>

Workflow timeline changes in application flow - The image below the one illustration on the right displays the old status view. Here the application status shows pending even if the task is completed. As per the current release, the application displays only the current state where the action is marked as pending. The remaining status is marked as done or completed or in a submitted state.

<figure><img src="/files/H22XxJN40oJzotGK7bcQ" alt=""><figcaption><p>Workflow timeline changes</p></figcaption></figure>

Notification based on channels - The residential construction permit application allows the user to configure different messages for different channels (In-app, mobile messages, email) for the same event in the application process flow.

## Known Issues <a href="#known-issues" id="known-issues"></a>

​<https://digit-discuss.atlassian.net/browse/UM-5599>

## Upcoming Release Features <a href="#upcoming-release-features" id="upcoming-release-features"></a>

None

## Reference Doc Links <a href="#reference-doc-links" id="reference-doc-links"></a>

| [Residential Construction Permit User Manual](/local-governance/access/local-governance-stack/online-building-plan-approval-system-obpas/obpas-user-manual) |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- |


# Local Business License Issuing System - Release Notes

Release notes for local business license issuing system

## Overview

A few reports are added to the TL module for administrative purposes.

## Release Highlights

Daily collection report

Application status report

Trade license registry

Trade license renewal pending report

## Release Features

Trade license daily collection report

<figure><img src="/files/bfBQ6Lc1dred3VIJcDP1" alt=""><figcaption><p>TL Daily Collection report</p></figcaption></figure>

Trade license application status report

<figure><img src="/files/r95SuDmTB94wEqjIF1f6" alt=""><figcaption><p>TL Application status report</p></figcaption></figure>

Trade license registry

<figure><img src="/files/kdBkCrMDFVyalAoXB88Z" alt=""><figcaption><p>Trade license registry</p></figcaption></figure>

Trade license renewal pending report

<figure><img src="/files/v6pzmEIgVtFPpJnIr48l" alt=""><figcaption><p>Trade license renewal pending report</p></figcaption></figure>

## Known Issues

[https://digit-discuss.atlassian.net/browse/UM-5286\
https://digit-discuss.atlassian.net/browse/UM-5625\
https://digit-discuss.atlassian.net/browse/UM-5682\
https://digit-discuss.atlassian.net/browse/UM-5547\
https://digit-discuss.atlassian.net/browse/UM-5554\
https://digit-discuss.atlassian.net/browse/UM-5692](<https://digit-discuss.atlassian.net/browse/UM-5286&#xA;https://digit-discuss.atlassian.net/browse/UM-5625&#xA;https://digit-discuss.atlassian.net/browse/UM-5682&#xA;https://digit-discuss.atlassian.net/browse/UM-5547&#xA;https://digit-discuss.atlassian.net/browse/UM-5554&#xA;https://digit-discuss.atlassian.net/browse/UM-5692&#xA;>)

## Upcoming Release Features

None


# Water & Sanitation UI/UX Revamp Release Notes

## Overview <a href="#overview" id="overview"></a>

This release provides UI/UX revamp of existing features of water and sewerage modules in addition to applying for disconnection, data privacy, and 3 standard reports.

## Release Highlights <a href="#release-highlights" id="release-highlights"></a>

UI/UX revamp of water and sewerage covers the features given below.

#### Citizen <a href="#citizen" id="citizen"></a>

1. My Connections
2. My Applications
3. My Payments
4. My Bills
5. Search and Pay
6. Apply for a new connection
7. Apply for disconnection
8. View Connection Details
9. View Consumption Details
10. View Application Details
11. Pay Water and Sewerage Bill
12. Pay Application Fee

#### Employee <a href="#employee" id="employee"></a>

1. Water Inbox
2. Sewerage Inbox
3. Apply for a new connection
4. Modification of connection
5. Bill Amendment
6. Application Workflows
7. Search Connection
8. Search Application
9. View Connection Details
10. View Consumption Details
11. Add Meter Reading
12. View Application Details
13. Collect Application Fee
14. Collect Water and Sewerage Bill

#### Downloads/ PDFs <a href="#downloads-pdfs" id="downloads-pdfs"></a>

1. Connection Details
2. Application Acknowledgement/ From
3. Estimation Notice
4. Sanction Letter

#### New Features Added <a href="#new-features-added" id="new-features-added"></a>

1. Disconnection of water and sewerage connection.
2. Disconnection Notice PDF
3. Application acknowledgement/form PDF

#### Reports <a href="#reports" id="reports"></a>

1. Receipt Register
2. Collection Register
3. Defaulters Report

#### Data Privacy <a href="#data-privacy" id="data-privacy"></a>

1. Masking of PII data
2. Option to unmask the PII data
3. Audit trail of the unmasking of PII data

## Release Features <a href="#release-features" id="release-features"></a>

<table><thead><tr><th width="260">Key Features</th><th>Description</th></tr></thead><tbody><tr><td><strong>CITIZEN</strong></td><td> </td></tr><tr><td>Apply for new connection</td><td>UI/UX revamp and change in application form to remove the information which is to be filled by employee.</td></tr><tr><td>Search and Pay</td><td>UI/UX revamps and added by Door no. and Owner’s Name.</td></tr><tr><td>My Payments</td><td>UI/UX revamp of payment history to My Payments.</td></tr><tr><td>My Bills</td><td>Added My Bills to list all the bills due for payment.</td></tr><tr><td>My Connections</td><td>UI/UX revamp of Search Connection and Card view of Connection Details.</td></tr><tr><td>View Connection Details</td><td>UI/UX revamps of complete view connection details.</td></tr><tr><td>View Consumption Details</td><td>UI/UX revamps of complete view of consumption details.</td></tr><tr><td>My Applications</td><td>UI/UX revamps of Search Application to My Applications and Card view of application details.</td></tr><tr><td>View Application Details</td><td>UI/UX revamps of complete view application details.</td></tr><tr><td>Pay Application Fee</td><td>UI/UX revamps of complete flow of payment of application fee.</td></tr><tr><td>Apply for disconnection</td><td>A new feature added to allow the consumer of the service to apply for is disconnection.</td></tr><tr><td>Data Privacy Audit Report</td><td>This report is added to see the details who all have unmasked to see the logged in user’s PII data.</td></tr><tr><td><strong>EMPLOYEE</strong></td><td> </td></tr><tr><td>Employee Inbox</td><td>UI/ UX revamp of inbox and separating out the water and sewerage inboxes.</td></tr><tr><td>Apply for new connection</td><td>UI/ UX revamp of and change in application form to remove the information which is to be filled by Field Inspector.</td></tr><tr><td>Search Applications</td><td>UI/ UX revamp of Search Application.</td></tr><tr><td>View Application Details</td><td>UI/ UX revamp of Search Application details.</td></tr><tr><td>Application Workflow</td><td>UI/ UX revamp of all the states of application flow and the option to edit the application by the FI only to add the additional details</td></tr><tr><td>Collect Application Fee</td><td>UI/ UX revamp of Collect Application Fee.</td></tr><tr><td>Search Connection</td><td>UI/ UX revamp of Search Connection.</td></tr><tr><td>Collect Water/ Sewerage Bills</td><td>UI/ UX revamp of Collect the Water/ Sewerage Bills.</td></tr><tr><td>View Connection Details</td><td>UI/ UX revamp of view connection details</td></tr><tr><td>View Consumption Details</td><td>UI/ UX revamp of view consumption details</td></tr><tr><td>Add Meter Reading</td><td>UI/ UX revamp of add meter reading.</td></tr><tr><td>Modify Connection</td><td>UI/ UX revamp of modify connection.</td></tr><tr><td>Bill Amendment</td><td>UI/ UX revamp of bill amendment.</td></tr><tr><td>Apply for disconnection</td><td>New feature to apply for disconnection has been added.</td></tr><tr><td>Data Privacy</td><td><p>Data privacy aspect is added to mask the PII data of a consumer and capturing the information up on unmasking of PII to generate the report.</p><ol><li>View Connection Details</li><li>View Application Details</li><li>Modify Connection</li></ol></td></tr><tr><td>Reports</td><td><ol><li>Receipt Register</li><li>Collection Register</li><li>Defaulters Report</li></ol></td></tr></tbody></table>

## Known Issues <a href="#known-issues" id="known-issues"></a>

[https://digit-discuss.atlassian.net/browse/UM-5637\
https://digit-discuss.atlassian.net/browse/UM-5293](<https://digit-discuss.atlassian.net/browse/UM-5637&#xA;https://digit-discuss.atlassian.net/browse/UM-5293&#xA;>)

## Upcoming Release Features <a href="#upcoming-release-features" id="upcoming-release-features"></a>

None

## Reference Doc Links <a href="#reference-doc-links" id="reference-doc-links"></a>

| Link                                                                                                  |
| ----------------------------------------------------------------------------------------------------- |
| [User Manual](/local-governance/access/local-governance-stack/water-and-sewerage/w-and-s-user-manual) |

&#x20;


# Bill Amendment UI/UX Revamp Release Notes

## Overview <a href="#overview" id="overview"></a>

UI/ UX revamp of bill amendment.

## Release Highlights <a href="#release-highlights" id="release-highlights"></a>

UI/UX revamp of Bill Amendment Inbox and Application View.

## Release Features <a href="#release-features" id="release-features"></a>

<table><thead><tr><th width="193">Key Features</th><th>Description</th></tr></thead><tbody><tr><td>Inbox</td><td>UI/UX revamp of employee inbox and service wise separate inboxes.</td></tr><tr><td>View Application</td><td>UI/ UX revamp of the application details view.</td></tr></tbody></table>

## Known Issues

None

## Upcoming Release Features <a href="#upcoming-release-features" id="upcoming-release-features"></a>

None

## Reference Doc Links <a href="#reference-doc-links" id="reference-doc-links"></a>

| **Doc Links** |
| ------------- |
|               |
|               |

<br>


# Bill Genie UI/UX Revamp Release Notes

## Overview <a href="#overview" id="overview"></a>

UI/ UX revamp of Bill Genie.

## Release Highlights <a href="#release-highlights" id="release-highlights"></a>

UI/UX revamp of Bill Genie features.

## Release Features <a href="#release-features" id="release-features"></a>

| Features          | Description                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| Search Bill       | UI/UX revamps of searching a bill and then downloading the bill PDF. Bill amounts can also be collected. |
| Cancel Bill       | UI/UX revamp of cancelling an active bill.                                                               |
| Group Bill        | UI/ UX revamp of the grouping and merging of the multiple bills into single PDF.                         |
| Group W\&S Bills  | UI/ UX revamp of grouping and merging of related water and sewerage bill into single PDF.                |
| Download Bill PDF | UI/ UX revamp of download PDF.                                                                           |

## Known Issues <a href="#known-issues" id="known-issues"></a>

None

## Upcoming Release Features <a href="#upcoming-release-features" id="upcoming-release-features"></a>

None

## Reference Doc Links <a href="#reference-doc-links" id="reference-doc-links"></a>

| **Doc Links** |
| ------------- |
|               |
|               |

&#x20;


# Birth & Death Reports Release Notes

Birth and death release note for Urban DIGIT 2.8.

## Overview

Reports have been added to birth and death for administrative purposes.

## Release Highlights

Birth count report

Death count report

Birth and death certificate payment records

## Release Features

Birth count report

<figure><img src="/files/5hgrJBSUDaENBQSYsd44" alt=""><figcaption><p>Birth count report</p></figcaption></figure>

Death count report

<figure><img src="/files/tuyJFxivfzoOqGdm0TRR" alt=""><figcaption><p>Death count report</p></figcaption></figure>

Birth and death certificate payment report

<figure><img src="/files/DKKZFURmajs38S2J1ijc" alt=""><figcaption><p>Birth and death certificate payment records</p></figcaption></figure>

## Known Issues

[https://digit-discuss.atlassian.net/browse/UM-5256](<https://digit-discuss.atlassian.net/browse/UM-5256&#xA;>)

## Upcoming Release Features

None


# National Dashboard Enhancement Release Notes

DSS release note for Urban DIGIT 2.8

## Overview

About page, FAQ and 3 new KPIs are added to the DSS page

## Release Highlights

About page for the dashboard is added which helps users to understand the purpose, how data is secure and from where the data is being pushed.

And 3 new KPIs were added for administrative purposes.

## Release Features

About page

<figure><img src="/files/vRLi0cCHYzFR33HmRVGk" alt=""><figcaption><p>About page</p></figcaption></figure>

FAQ

<figure><img src="/files/gh4XTrlNQbHBGKcbYXcG" alt=""><figcaption><p>FAQ</p></figcaption></figure>

3 KPIS - Non-tax revenue collected, Non-tax revenue contribution % and Average PT collected.

<div><figure><img src="/files/dWQd03Squujt9S0nlIJu" alt=""><figcaption></figcaption></figure> <figure><img src="/files/acViOosSL0I1zejxSmTI" alt=""><figcaption></figcaption></figure></div>

## Related Doc Links

|   |
| - |
|   |
|   |
|   |


# Survey Release Notes

## Overview

This module allows employees to create surveys for citizens and let them fill out surveys. Later survey results can also be seen on the Survey results dashboard.

## Release Highlights

The Survey module consists of the following

**For Employees**

1. Surveys section on Home Page
2. Surveys inbox
3. Create survey
   * Meta Data - Title, Description, Survey start & end date/time
   * Questions&#x20;
     * Short Answer
     * Paragraph
     * Single Answer
     * Multiple choice questions
     * Date&#x20;
     * Time
4. Survey Results
   * Aggregated view of all survey results in specific charts for each question type
   * Download the excel report with the survey results
5. Modify surveys
   * Survey questions
   * Extend the Survey date and time.

**For Citizens**

1. Notification on Survey creation.&#x20;
2. Survey Filling

## **Known Issues/ Upcoming Enhancements**

1. Expansion to other types of questions
2. More notifications to citizens prior to survey start, and survey end.
3. Making surveys open. (Right now citizens need to be logged in to fill out the survey. This needs to be made open)

[https://digit-discuss.atlassian.net/browse/UM-5697\
https://digit-discuss.atlassian.net/browse/UM-5700](<https://digit-discuss.atlassian.net/browse/UM-5697&#xA;https://digit-discuss.atlassian.net/browse/UM-5700&#xA;>)

## Related Doc Links

|                                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Survey User Manual](/local-governance/access/local-governance-stack/citizen-engagement-module/survey/survey-user-manual)                                                      |
| [Survey Service Configuration](/local-governance/access/local-governance-stack/citizen-engagement-module/survey/survey-service-configuration)                                  |
| [Help/FAQ Citizen UI Configuration](/local-governance/access/local-governance-stack/citizen-engagement-module/survey/survey-service-configuration/help-faq-section-citizen-ui) |


# Product Specific Pages Release Notes

## Overview

This module gives citizens more information on a service delivery module than just links to access the service.

## Release Highlights

Product Specific Pages Module consists of the following:

**For Citizen**

For a module and tenant that is configured.

1. FAQs
   * List of FAQs for each module
2. How it works
   * List of user manuals, help videos etc (Also in local language)
3. Link to access service via WhatsApp
4. Helpline Numbers
5. Address of Service Centres
   * Link to navigate to google maps
6. Static data
   * Ex. Days to process applications/ Amount to pay while applying etc
7. Dynamic Data
   * Number of citizens applied for service in last n months/ Amount collected etc

## **Known Issues/ Upcoming Features**

* [UM-5628](https://digit-discuss.atlassian.net/browse/UM-5628)
* [UM-5721](https://digit-discuss.atlassian.net/browse/UM-5721)
* [UM-5640](https://digit-discuss.atlassian.net/browse/UM-5640)
* [UM-5725](https://digit-discuss.atlassian.net/browse/UM-5725)

## Related Doc Links

|   |
| - |
|   |
|   |
|   |


# Understanding Local Governance

Local governance approach

## Overview

The Local Governance stack is a set of open APIs, services, and reference implementations, set up as a public good, to allow government entities, businesses, startups, and civil society to use a unique digital infrastructure and build solutions for urban India at a large scale. It provides a set of open standards, specifications and documentation to create a level playing field and enable ecosystem players to innovate on the stack. As a public good, the solutions are available to all members of society without profits or restrictions.

![](/files/-MMu60u0J25rEzMUxwEh)

![](/files/-MMu60u14nMmXSX4x0S2)

## Goals

The urban mission offers digital governance solutions that encapsulate the core platform principles. The apps provide

* Secure & reliable governance tools
* Simple reusable modules for effective integration
* Scalable & standardized solutions
* Open APIs to promote interoperability
* Multiple channel support
* Configurable building blocks that support customization at each stage

## Approach

The local governance focuses on inclusion and is designed to enhance both platform openness and choice for citizens. The platform uses open APIs and standards, creating a powerful framework to drive convergence across the multiple systems currently in use and to lower the barrier to entry for locally developed solutions.&#x20;

Keeping in mind that most Indians use the internet through their phones, we follow and advocate a “mobile-first” approach, while supporting multi-channel access to accommodate diverse needs and preferences.

![](/files/-MMu60u3TBWd2HSfzJsd)

* **Open Source** - The local governance stack is open source and has been built using the best-in-class open-source technology stacks powering the most advanced companies in the world. The solution can provide the lowest total cost of ownership and helps ensure that governments retain strategic control of their systems and data.
* **Mobile-Enabled** - The local governance solution design follows a mobile-first approach, with robust mobile applications enabling citizens to access government services through their phones easily. Government officials and field workers are also empowered with mobile applications that enable them to deliver 24×7 governance with ease.
* **Real-time Dashboards** - The real-time dashboards provide governments with actionable insights on demand. Administrators and department heads are empowered with verified data that enables them to manage their work and budgets better. Field-level employee reports enable effective performance management and ensure efficient usage of government resources.


# Value Proposition

<table data-card-size="large" data-view="cards" data-full-width="true"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><em><strong>01</strong></em><strong> - Accelerated Reforms</strong></td><td><p><img src="/files/Mmafics3V8kkpZcTGW63" alt="" data-size="original"> </p><p>The Local Governance transforms the way governments deliver public services.</p><p></p><p>By establishing a digital public infrastructure (DPI), multiple states have built capacity, removed administrative burdens, and improved governance, enabling faster, better, and cheaper delivery of public services.</p><p></p><p>Governments face multiple challenges in transformation initiatives, including capacity issues, emergent needs and behaviours, and variance in context and requirements at different scales.</p><p></p><p>DIGIT was designed from the ground up to address such challenges and has evolved over multiple years of implementation to solve for accelerated reforms.</p></td><td></td></tr><tr><td><em><strong>02</strong></em><strong> - Trustworthy Data For Effective Decision Making</strong></td><td><p><img src="/files/8Lh4ffKsODbg40Dbksmo" alt="" data-size="original"></p><p>Timely and trustworthy data for effective decision-making at different administrative levels and to fix accountability. DIGIT Local Governance comes ready with data dashboards to enable decision-making at all levels of government, right from administrators to frontline workers.</p><p>DIGIT makes possible:</p><ul><li>interoperability</li><li>Easy sharing of data</li><li>Single source of truth</li></ul><p>This ensures that products built on DIGIT enhance visibility, increase trust and reduce the cost of coordination across multiple departments and programs.</p></td><td></td></tr><tr><td><em><strong>03</strong></em><strong> - Improved Productivity &#x26; Faster Adoption</strong></td><td><p><img src="/files/QfbTvI0JFxrRfObgQaNk" alt="" data-size="original"></p><p>Reduce overheads for technology teams and learning curve for the final product users.</p><p></p><p>Single login for multiple applications and a standardised user interface make adoption quicker and easier. Role-based access takes away the overheads of multiple environments for different systems and multiple user accounts for each system.</p><p></p><p>For employees, it removes having to do tedious, repetitive tasks by automating processes, improving productivity, and allowing them to focus on more meaningful aspects of their jobs.</p></td><td></td></tr><tr><td><em><strong>04</strong></em><strong> - Sustainable Impact At Scale &#x26; Speed</strong></td><td><p><img src="/files/TcgJKVhD6okkWssemCeQ" alt="" data-size="original"></p><p>Scalability is at the core of the DIGIT platform. It has been deployed as a digital public infrastructure serving large-scale sub-national and national populations.</p><p></p><p>What makes it possible? A technologically robust platform with open and freely available specifications and standardised APIs that have proven its performance at massive deployments at the population scale.</p><p></p><p>DIGIT's source code is open source, data is stored in shared registries and data stores are owned by the government, mitigating the risks associated with vendor lock-ins, and allowing digital transformation initiatives to move ahead with speed at scale.</p></td><td></td></tr><tr><td><em><strong>05</strong></em><strong> - Enhanced Citizen Access To Public Services</strong></td><td><p><img src="/files/0jXbJPCf6VFoP9UZUNCq" alt="" data-size="original"></p><p>Local Governance solutions built on DIGIT can be accessed by multiple channels. So that, services can be delivered to citizens via mobile, web, WhatsApp, chatbots, through intermediaries or over the counter in physical offices. All are seamlessly connected.</p><p></p><p>It comes ready with a well-defined design system with a standardised user interface that has been created considering the realities of population-scale digital products. The user interface is straightforward and minimal. It follows a guided approach for citizens using these digital products.</p></td><td></td></tr><tr><td><em><strong>06</strong></em><strong> - Quick Development, Easy Deployment</strong></td><td><p><img src="/files/6cQ7Grm3BgL9vlEPJwAG" alt="" data-size="original"></p><p>All products on DIGIT are designed to be configured, customised, and extended to suit the needs of the local context. These changes can be made at different levels of government.</p><p>A federated architecture supports the different realities of each unit of governance.</p><p></p><p>A set of reusable building blocks can be leveraged by market players to build products and services rapidly. Well-defined specifications, documentation, guides, and training materials make deployment quick and easy for teams. Thus, making it possible to build products for different programs and services, urgent needs and take them to the ground as fast as possible.</p></td><td></td></tr><tr><td><em><strong>07</strong></em><strong> - Strong Network Of Trusted System Integrators</strong></td><td><p><img src="/files/cze3qMsw3ntmu8HS1eZK" alt="" data-size="original"></p><p>The DIGIT team works actively with partners and has created a robust ecosystem of application developers and system integrators who are trained and certified in DIGIT.</p><p>Open training sessions on design, development, deployment and implementation are held regularly. In addition to that, DIGIT provides certifications to trained personnel.</p></td><td></td></tr><tr><td><em><strong>08</strong></em><strong> - Continued Platform Support</strong></td><td><p><img src="/files/A8wLEuanLvfnIu4tIX4A" alt="" data-size="original"></p><p>For governments using DIGIT as their technology platform, the DIGIT team offers:</p><ul><li>Advisory support in vendor selection</li><li>Product design review, architecture design review</li><li>Enablement of system integrators selected by the government</li><li>Open training sessions | Certifications | Implementation guidance | Platform performance review</li></ul><p>DIGIT promises long-term support of the platform for all its core components and also underwrites the performance of the core platform.</p></td><td></td></tr><tr><td><em><strong>9</strong></em><strong> - Designed For Global Challenges, Recognised Globally</strong></td><td><p><img src="/files/A1TmhenixSteQlvooIaO" alt="" data-size="original"></p><p>DIGIT has the capabilities needed to rapidly develop digital applications to address global development challenges. From its origin in solving for urban governance, the platform has rapidly evolved to address challenges in areas of sanitation, public health welfare, public finance, rural governance and legal case management among others.</p><p></p><p>DIGIT is certified as a Digital Public Good (DPG) by the Digital Public Goods Alliance (DPGA). The DIGIT team sits on the technical advisory committee of the Govstack that works to identify and support the advancement of digital public goods with relevance to the whole of the government transformation approach.</p></td><td></td></tr></tbody></table>


# Local Governance Stack


# Local Business License Issuing System

Apply for trade license, ensure compliance with trade safety guidelines, and lots more

## About Local Business License Issuing System

The Local Business License Issuing System enables local government bodies to regulate trading establishments. It also serves to protect the interest of the public at large against possible health hazards and inconveniences that any business operation can cause. With the Business License Issuing application traders can obtain the trade certificate in a simplified manner and ensure compliance with rules and safety guidelines issued by the government. The module offers the citizens and governance bodies a convenient and transparent means of processing trade licenses.

The application makes obtaining a trade licence easy, smooth, and transparent. Hence, the module removes the need for manual processing and streamlines the key trade licence management functions to provide a better user experience.

Click on the link below to download the trade licence brochure.

{% file src="/files/IBi3LLhy2PMvHzSbXN7T" %}

## Key Features

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-type="users" data-multiple></th></tr></thead><tbody><tr><td><strong>Citizen Users</strong> </td><td><p><strong>A</strong>pply for a new trade licence or renew an existing trade licence</p><p></p><p><strong>U</strong>pload all the relevant documents required for the licence</p><p></p><p><strong>M</strong>ake payment for the Trade Licence (New/Renewal) fee using the online payment gateway</p><p></p><p><strong>R</strong>eceive notifications and alerts by email or SMS for new application status updates and pending renewals</p><p></p><p><strong>D</strong>ownload Trade Licence, Payment &#x26; Acknowledgement Receipts online</p></td><td></td><td></td></tr><tr><td><strong>Employee Users</strong> </td><td><p><strong>C</strong>reate flexible role-based workflows</p><p></p><p><strong>C</strong>onfigure license fee calculation logic</p><p></p><p><strong>V</strong>iew custom dashboards for module statistics</p><p></p><p><strong>F</strong>ilter search results using advanced configurable search parameters</p></td><td></td><td></td></tr></tbody></table>

## Section Overview

This section contains all docs and information required to understand the Business Licensing module, its key features, functional scope, and configuration details. Click on the links below to learn more about deploying, configuring, customising, and using the business license issuing module.

* [Functional Specifications](/local-governance/access/local-governance-stack/trade-license-tl/tl-module-functional-specifications)
* [Local Business License Issuing User Manual](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual)
* [Master Data Configuration Templates](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates)
* [Local Business License Issuing System Service Configuration](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration)
* [Implementation Handbook](/local-governance/access/local-governance-stack/trade-license-tl/tl-implementation-guide)

{% hint style="warning" %}
**Navigation Tips**

* Click on the embedded links within the content to browse topic details
* Use the Contents links available on the right side of the screen to move to a specific heading
* Find the list of Related Docs links at the bottom of each page to browse through additional product details
  {% endhint %}


# Local Business License Issuing Module Functional Specifications

Functional overview for stakeholders

## Introduction

The Local Business License Issuing application provides a digital interface, allowing citizens to apply for the Trade Licence and subsequently make the trade licence fee payment online.

The Local Business License Issuing application enables:

* Ease of doing business — Traders can apply for new licences, renewals, amendments, and supplemental licences
* Regulatory Tracking — Administrators can track and manage regulatory processes
* Shorter Timelines — Streamline and automate business licencing processes and help a business to be set up quickly
* Data-driven decision making — The application collates valuable information on the economic activity and employment opportunities in a ULB

## Functional Scope

The list below summarizes the key features supported by the TL module -

1. [Registration, Login and Creation of User Profile](#registration-login-and-creation-of-user-profile)
2. [Apply for a Trade Licence](#applying-for-a-trade-licence)
3. [Trade Licence Issue](#trade-license-issue)
4. [Modifications to a Trade Licence](#modifications-to-a-trade-licence)
5. [Renewal of Trade Licence](#trade-licence-renewal)
6. [Payments and Fee](#payment-and-fee)
7. [Dashboards and Reports](#dashboards-and-reports)
8. [General Features](#general-features)

### Registration, Login and Creation of User Profile

{% hint style="warning" %}
Key capabilities offered by this functional component -

* OTP-based login for citizens via Web/Mobile App
* OTP-based login for employees via Web/Mobile App
* Provision for language selection during registration for both employees and citizens
* Provision of creating a personalized profile for citizens and employees on the Web/App
* Login credentials for the various hierarchies of employees
* Role-based access for performing different actions relating to Trade License modules
  {% endhint %}

### Applying for a Trade Licence

Users can apply for a new Trade Licence from the system. They can select the type of license to apply. The user enters trade details, owner details and documents after which the application can be reviewed and submitted. Similarly, a counter employee can also apply for a trade licence on behalf of the citizen. The system has a workflow integration that enables stage-wise approval before issuing the Trade Licence.

{% hint style="warning" %}
Key capabilities offered by this functional component -

* Citizens can apply for a new trade licence through mobile app/web
* Citizens/CSC can capture trade details, trade units, accessories, owner details, address, purpose, date of issuance, licence number etc.
* Citizens/CSC can upload supporting documents
* Citizens/CSC can calculate breakup based on selected trade
* Citizens/CSC can select multiple accessories for the trade
* Citizens/CSC can apply for multiple trade licences
* Citizens/CSC can download/print application summary
* Citizens/CSC can download/print trade reference number
* Citizens/CSC can view the applied licences
* The system has the facility to deliver the service online & through SEWA KENDRA.
* The portal displays all the information including the processes and documents required for citizen convenience.
* The system has the facility to assign a unique identification number based on the licence type, which will be used for all future transactions linked to the licence.
  {% endhint %}

### Trade License Issue

The system has the facility to assign the application to the respective Inspector for survey and verification. After the application is submitted, it goes to the document verifier. The next step after document verification is field inspection. After the field inspector’s approval, the TL is approved by the approver.

{% hint style="warning" %}
Key capabilities offered by this functional component -

* Document Verifier - verifies & forwards or rejects the application
* Licensing Inspector - verifies and forwards the application
* Licensing Inspector - sends back or rejects the application
* Licensing Inspector - approves the application
* Citizen - pays for the licence post-verification process online or at the CSC
* CSC - collects fee post-verification
* The system allows the printing of the licence and sending the licence through e-mail.
* The system allows SMS alerts to the applicant regarding the date of inspection/visit by the inspector and approval/rejection of the application.
* The system allows the inspector to enter the field visit details and a field visit report is generated and automatically routed to the superintendent.
  {% endhint %}

### Modifications to a Trade Licence

The system has the facility to edit/update the application based on the inspection report against the application.

### Trade Licence Renewal

The system has the facility to provide a hassle-free renewal process for citizens and employees, leading to increased revenues, by reducing unlicensed trades. The system allows the sending of SMS and email notifications and reminders based on the renewal cycle.

### Payment and Fee

{% hint style="warning" %}
Key capabilities offered by this functional component -

* The citizen can pay for the licence post-verification process
* CSC - collects fees post-verification
* The system allows intimating the applicant about the payment of the licence fee through SMS/email
* The system allows the generation of receipts for the payment
* The payment modes enabled are Card (offline), cash, cheque, DD
  {% endhint %}

### Dashboards and Reports

{% hint style="warning" %}
Following reports offered by the module -

* Cancelled receipt register report
* Trade licence collection
* Trade licence application status- showing the number of licences approved/rejected.
* Trade licence ULB-wise status
* State dashboard: View Reports for Total Licences, Licences Issued, Payment Collected, Payment Distribution
  {% endhint %}

### General Features

{% hint style="warning" %}
**Notifications -** The system can send notifications to citizens. These notifications can be sent for various steps like - verification completion, payment reminder, and payment confirmation. These notifications can be sent in the language chosen by the ULB through all channels - SMS, WhatsApp, and Email.

**Configurable Masters** - The system provides the following masters that can be configured as per the State’s requirements:

* Charges & calculation: calculation engine, rebate, penalty,
* Rate Master
* State Masters: Trade Ontology, Documents List, Accessories, Ownership, Employee Data Mapping, Boundary Data Mapping, Fee Matrix (Licence Fees)
  {% endhint %}

System specification in compliance with the Ease of Doing Business (EODB) BRAP 2019

<table><thead><tr><th width="97">Reform Number</th><th width="140">Reform Area</th><th width="112">Weightage (score)</th><th width="326">Recommendation</th><th>Remarks</th></tr></thead><tbody><tr><td>80</td><td>Sector Specific</td><td>2</td><td><p>Implement an online application system with the following features:</p><p>i. Online submission of application without the need to submit physical copy of application</p><p>ii. Eliminate physical touchpoint for document submission</p><p>iii. Allow option of online payment of application fee</p><p>iv. Allow applicant to track status of application online</p><p>v. Applicant can download the final certificate online</p></td><td>Already available in the system</td></tr></tbody></table>

### List of Features- Trade Licence

<table><thead><tr><th width="359">List of Functionalities</th><th>Corresponding Features</th></tr></thead><tbody><tr><td>Registration, Login, Creation of User Profile</td><td>Provision for Language Selection during first-time registration via Mobile/Web app.</td></tr><tr><td>OTP Based Login for Citizen/ Employee via Mobile/ Web App</td><td></td></tr><tr><td>Login Credentials for the various hierarchy of employees</td><td></td></tr><tr><td>Provision of Personalized Profile for Citizen/ Employee on Web App</td><td></td></tr><tr><td>Applying for a Trade Licence</td><td>Citizen/CSC: Enters Trade Details, Trade Units, Accessories, Owner Details.</td></tr><tr><td>Citizen/CSC: Upload Documents</td><td></td></tr><tr><td>Citizen/CSC: ULB Wise Trade Selection</td><td></td></tr><tr><td>Citizen/CSC: Calculation Breakup Based on Selected Trade</td><td></td></tr><tr><td>Citizen/CSC: Multiple Accessories Field Count</td><td></td></tr><tr><td>Citizen/CSC: Multiple Trade Licence</td><td></td></tr><tr><td>Citizen/CSC: Download/Print Application Summary</td><td></td></tr><tr><td>Citizen/CSC: Download/PRINT Trade Reference No</td><td></td></tr><tr><td>Citizen/CSC: View the applied licences</td><td></td></tr><tr><td>Citizen: Pays for the licence post-verification</td><td></td></tr><tr><td>CSC: Collects fee post verification</td><td></td></tr><tr><td>Issue of trade licence</td><td>Document Verifier : Verify &#x26; Forward/ Reject the application</td></tr><tr><td>Licencing Inspector: Verify and Forward/ Send back/ Reject the Application.</td><td></td></tr><tr><td>Licencing Officer: Approve/ Send back the Application</td><td></td></tr><tr><td>Licencing Officer: Reject/ Cancel the Application</td><td></td></tr><tr><td>Modification to a Trade Licence</td><td>Edit/ Update the Application based on the Inspection report against the application.</td></tr><tr><td>Renewal of a Trade Licence</td><td>Renew trade licence</td></tr><tr><td>Payment and Fee</td><td>Configurable Workflow Rights : Edit &#x26; Payment Collection</td></tr><tr><td>Payments &#x26; Collection : Various Payment Modes</td><td></td></tr><tr><td>Dashboards and reports</td><td>Cancelled Receipt Register Report</td></tr><tr><td>Trade licence collection</td><td></td></tr><tr><td>Trade licence application status- showing the number of licences approved/rejected</td><td></td></tr><tr><td>Trade licence ULB-wise status</td><td></td></tr><tr><td>State Dashboard: View Reports for Total Licences, Licences Issued, Payment Collected, Payment Distribution</td><td></td></tr><tr><td>General features</td><td>Notifications : SMS Notifications</td></tr><tr><td>Charges &#x26; Calculation : Calculation Engine</td><td></td></tr><tr><td>Charges &#x26; Calculation : Rebate/ Penalty- Date Based</td><td></td></tr><tr><td>Charges &#x26; Calculation : Ad-Hoc Rebate/ Penalty</td><td></td></tr><tr><td>Charges &#x26; Calculation : Exemptions Trade Type &#x26; Owner Type</td><td></td></tr><tr><td>Configuration masters</td><td>Configurable Workflow Rights : Edit &#x26; Payment Collection</td></tr><tr><td>Configurable Verification &#x26; Approval</td><td></td></tr></tbody></table>


# Local Business License Issuing User Manual

An illustrative guide to using the business license issuing module

The module offers citizens and governance bodies a convenient and transparent means of processing trade licenses. A trade licence is permission the local governing bodies issue to carry on a specified business or trading activity within the authorized area. It is a mandatory document required to run a business or commercial activity.&#x20;

{% hint style="info" %}
**Tip:** Click on the links on the flow diagram below to access the docs for the specified action.&#x20;
{% endhint %}

{% embed url="<https://www.canva.com/design/DAGQWdM0KQA/ZF1eHY0G5FpuNJl5swRrpg/view?utm_content=DAGQWdM0KQA&utm_campaign=designshare&utm_medium=link&utm_source=editor>" %}
Trade License User Flow
{% endembed %}

## **Using Local Business License Issuing Module**

Click on the relevant role below to learn more about how to use the trade license solution.

1. [Citizens](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual)
2. [Counter Employee (CE)](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual)
3. [Document Verifier (DV)](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#document-verifier-dv)
4. [Field Inspector (FI)](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#field-inspector-fi)
5. [Approver](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual#approver)


# Business License - Citizen User Manual

Learn how to apply for new trade licence, renew and pay trade licence fee

## **Citizens and CE**

Citizens represent individuals, communities, or business entities who are the system end-users. The TL module allows business owners to apply for a trade license online or even apply for the renewal of an existing license.

The citizen can also approach the Counter Employee (CE) to submit new TL applications or raise renewal requests for existing licences.

**The Citizen or CE role can -**

* [Apply for a new business license](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual/apply-for-new-trade-licence)
* [Renew business licence](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual/renew-trade-license)
* [View application status and pay](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/citizen-user-manual/view-application-status-and-pay)


# Apply For New Trade Licence

<figure><img src="/files/qGetbWqy6Ljidu0sLUyx" alt=""><figcaption></figcaption></figure>

Citizens or CEs can apply for a new trade licence through the DIGIT web portal or the DIGIT mobile app. To apply for a new trade licence click on the **Trade Licence** card available in the **Citizen Services** section of the DIGIT home page.

| <img src="/files/RT2AcCU0PfafrCBFZd7H" alt="" data-size="original">                                                                                                                       | <img src="/files/IkUb8Qg3zzO9XNSahFGg" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click on **Apply for Trade License.**                                                                                                                                                     | The initial application screen displays the list of documents that have to be submitted for trade license registration. Scroll through the list and make sure the required documents are scanned and ready for submission online.                                                                                                                                                   |
| <img src="/files/XEaUYVTPKp62BXF6Wx7w" alt="" data-size="original">                                                                                                                       | <img src="/files/GgXp3cKHO4zVzxncLxmz" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Enter the **Trade Name**. Click on the **Next** button.                                                                                                                                   | Click on the **Yes** or **No** option to indicate the **Structure Type** of the trading premises. **Yes** to indicate the trade will run on an immovable structure. And, **No** to indicate the trade will run on a movable structure.                                                                                                                                              |
| <img src="/files/oyYP2GT2uDBiI6z6GDvo" alt="" data-size="original">                                                                                                                       | <img src="/files/3NkwDjqiMZiR88maxgya" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Select **Pucca** or **Kutcha** option to indicate the **Building Type**. The **Building Type** option appears if the selected **Structure Type** in the previous screen is **Immovable**. | In the case of **Movable** structures, the system displays the **Structure Sub Type** as **Vehicle Type**. Select **Hand Driven Vehicle** or **Motor-Driven Vehicle** option depending on the trading plans.                                                                                                                                                                        |
| <img src="/files/nSCoJCqjAYV1pYSYZ2U9" alt="" data-size="original">                                                                                                                       | <img src="/files/0DgPa1XO1Hb73gsk9o5H" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Enter the **Trade Commencement Date**. This date indicates the inception or starting date of the trade.                                                                                   | Select the **Trade Category** as either **Goods** or **Services** in the **Trade Units** screen. Next, select the appropriate **Trade Type** and **Trade Sub Type** from the available drop-down list. Click on **Add More Trade Units** button to append multiple trading units.                                                                                                   |
| <img src="/files/wsdjjIlWjThxTCmhy2Ut" alt="" data-size="original">                                                                                                                       | <img src="/files/yO5vBnq9cqIIB9iTBTcv" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Select **Yes** or **No** to indicate if you have any trade accessories.                                                                                                                   | If **Yes**, select the applicable **Accessory** from the drop-down list. Enter the **Count** for the selected **Accessory** to provide details on the number of accessories required. The system auto-populates the applicable **UOM**, if any, for the selected accessory. Enter the **UOM value**. Click on **Add More Trade Accessories** button to append multiple accessories. |
| <img src="/files/Pv6BupdzF5rW5KxoDg2V" alt="" data-size="original">                                                                                                                       | <img src="/files/LkWnZjEfGnPRbiHvRjZa" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Enable the **Location** Finder to allow GPS to track the current location. Or, move the pin to the location manually. Alternatively, you can also enter the location in the Search bar.   | The **Pincode** field gets auto-populated if the location is selected on the map. Else, enter the **Pincode** of the location details manually. Click on **Skip and Continue** in case you are unable to provide the Pincode details.                                                                                                                                               |
| <img src="/files/nQrIpa9rTssaQrlYHLbh" alt="" data-size="original">                                                                                                                       | <img src="/files/EphlKJYckYxai01zclFU" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| **City** and **Locality/Mohalla** fields are auto-populated once the **Pincode** is entered. Else, select the **City** and applicable **Locality/Mohalla** from the drop-down list.       | Enter the **Street Name** and **Door No.** details.                                                                                                                                                                                                                                                                                                                                 |
| <img src="/files/MyGbxlZKY9EXRGOHE2Y9" alt="" data-size="original">                                                                                                                       | <img src="/files/KJl6mIwrSfkKL9Va9gpb" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Provide a **Landmark** to locate the trading premise.                                                                                                                                     | Select either the **Single Owner** or **Multiple Owners** option to indicate the type of ownership in the **Ownership Details** screen.                                                                                                                                                                                                                                             |
| <img src="/files/jOWe3SdbgS8BLuBQzxE7" alt="" data-size="original">                                                                                                                       | <img src="/files/lta3ygfOBmQtxyMqwRal" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Enter the **Owner Name**. Select the applicable **Gender** and enter the owner’s **Mobile Number**.                                                                                       | Enter the **Owner’s Address**. Check the **Same as Trade Address** box if the owner’s address and trading address are the same. This will auto-populate the trading address provided earlier.                                                                                                                                                                                       |
| <img src="/files/4akNkNxdk0GlUOpNfya4" alt="" data-size="original">                                                                                                                       | <img src="/files/MDiyLxagSJBtQ65TjgkS" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Select **Choose File** and upload the relevant identity proof document.                                                                                                                   | Upload the **Ownership Document.** The supported file formats are jpg, PNG or PDF                                                                                                                                                                                                                                                                                                   |
| <img src="/files/cimoVl2Cx6Oy0AiEvOyq" alt="" data-size="original">                                                                                                                       | <img src="/files/AQjQLatbX3XMcJFcwD1S" alt="" data-size="original">                                                                                                                                                                                                                                                                                                                 |
| Upload the **Owner's Photograph**.                                                                                                                                                        | Validate the information entered in the application summary screen. Click on **Change** to modify the information if required. Click on the **Submit** button once the filled-in details are found correct and complete.                                                                                                                                                            |
| <img src="/files/m80Xwj4ylaCyRjZHFgYu" alt="" data-size="original">                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                     |
| The system generates a unique application reference number. Click on the **Download Acknowledgement Form** to download and print the acknowledgement.                                     |                                                                                                                                                                                                                                                                                                                                                                                     |


# Renew Trade License

Citizens can renew their existing trade applications on the DIGIT portal. CE can also apply for TL renewal on behalf of the citizens.&#x20;

| <img src="/files/HSTMpF3RjofKZvr7fUv7" alt="" data-size="original">                                                                                                                                                    | <img src="/files/jcfzk1OnhFb1TnQicgFg" alt="" data-size="original">                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| To renew TL navigate to the home page and click the **Trade License** option. Click on **My Applications**. Click on the **Renew Trade License** option to view the license details for renewal.                       | The system will display the license details. Click on the **Renew** button to apply for renewal. |
| <img src="/files/62L0OpYK7yL2cF8tfVPS" alt="" data-size="original">                                                                                                                                                    | <img src="/files/rz6lH1wl3XIWVueBrxGn" alt="" data-size="original">                              |
| If there are any changes in the trade details, click on the **Change** button adjacent to the fields before submitting for renewal. Click on the **Submit Application** button once all changes are done and reviewed. | The Trade License is submitted for renewal.                                                      |


# View Application Status & Pay

My Applications option allows applicants to view their applications and track their status.

| <img src="/files/diZgXRmUIPfuOiMWWDaO" alt="" data-size="original">                                                                                                                                | <img src="/files/v38WuvxvmQOkAPVKHdTH" alt="" data-size="original">                                                                                    |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Click on **My Applications**.                                                                                                                                                                      | The screen displays all the applications tagged to the registered mobile number. Click on the **View Details** button to view the application details. |
| <img src="/files/EQ5JWu7Fg2y1IGWaIZVq" alt="" data-size="original">                                                                                                                                | <img src="/files/ewAojL011iPh4Qtqwj2x" alt="" data-size="original">                                                                                    |
| The **Application Timeline** displays the selected application's current status and completed actions. For applications pending payment, click on the **Make Payment** button to make the payment. | Select the applicable **Payment Method** and click on the **Pay** button.                                                                              |
| <img src="/files/R8fPR8Wq9NAG9Tz5mUWq" alt="" data-size="original">                                                                                                                                |                                                                                                                                                        |
| Click on the **Receipt** or **Certificate** button to download the receipt or the processed trade license certificate. Else, click on the **Go Back To Home** button to go back to the home page.  |                                                                                                                                                        |


# Business License - Employee User Manual

This section illustrates the steps for different employee user roles at the local governance level

Employees can -

1. [Create applications on behalf of citizens](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/create-applications)
2. [Collect payment](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/collect-payment)
3. [Renew licence](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/renew-licence)
4. [Process application](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/process-application)
   * [Verify documents](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/process-application/verify-documents)
   * [Field inspection](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/process-application/field-inspection)
   * [Approve applications](/local-governance/access/local-governance-stack/trade-license-tl/tl-user-manual/employee-user-manual/process-application/approve-applications)


# Create Applications

Log in to the employee portal using your credentials.

![](/files/-MgiG_AmTb1AGXKCV9zF)

Click on the **New Application** option in the top left corner of the landing page.

![](/files/-MgiG_AoufgDhzez96CK)

An employee can create the application on behalf of citizens over the counter.

Select the applicable Financial Year for which the trade license is to be issued.

![](/files/-MgiG_Aqp90yNznSMmCF)

Fill in the application details (same as given in the citizen application process).

Click on the Submit button once all details are found complete and accurate.

![](/files/-MgiG_AsvevDXQj3FyYa)

A unique application reference number is generated. This number is used to access the application and for further processing. The citizen receives a notification along with this application number in the registered mobile number.


# Collect Payment

Click on **Inbox** to view the list of applications submitted.

![](/files/-MgiG_AuAs5qY0p7Q2E5)

Click on the relevant **Application Number** hyperlink to open and view the application details.

![](/files/-MgiG_Aw7CyTWQVNziOO)

Scroll down the application and click on the **Take Action** button. Click on **Pay**.

![](/files/-MgiG_Ayh58CWw36nuIr)

Enter the **Payment** and **Payer Details**. Click on **Collect Payment** to process the payment.

![](/files/-MgiG_B-HgF_I3nnbPni)

The system generates a unique payment **Receipt Number**. Click on the **Print Receipt** button to print the receipt. Click on the **Go Back to Home Page** button to navigate back to the home page.


# Renew Licence

Click on the **Renew Trade Licence** option on the home page.

![](/files/-MgiG_B2i6mE8S2nemkJ)

Click on the relevant **Trade Licence Number** to renew. Edit the trade license details in the application form as required.

Click on the **Take Action** button. Click on the **Renew Trade Licence** option.

![](/files/-MgiG_B3QklkyjTWiSrv)

The user can renew it without modifying the trade details or it can be modified. If it is modified, it goes into application processing similar to a new TL application. If it is not edited then renewal happens in real time after making payment.


# Process Application

Trade license applications pass through various stages where details are scanned, verified, and inspected before the final approval. The workflows are defined at the State or ULB level and adjusted to meet individual department requirements.

The prescribed stages through which trade license applications are routed include -

1. Document Verification
2. Field Inspection
3. Approval


# Verify Documents

Log in with **Document Verifier** credentials.

The employee landing page displays the list of applications waiting for processing. Use the search filters on the page to find specific applications from the list.

Click on the **Application Number** hyperlink to open the application.

![](/files/-MgiG_B5ZTPISlV8cOz5)

Scroll through the application details and review the uploaded documents.

Click on the **Take Action** button and click on **Verify and Forward** option if all documents are found complete and satisfactory.

![](/files/-MgiG_B8wV6hz4JbKoy-)

Select the **Assignee Name**. The application will be forwarded to the selected assignee for field inspection.

![](/files/-MgiG_BA2C3BNrIM3kwa)

In case, the documents are found incomplete or missing, click on **Send Back to Citizen** option. This will send back the application to the citizen for necessary action.

Click on the **Reject** option if the application details are found inaccurate. This will reject the application.


# Field Inspection

Log in with Field Inspector credentials.

The employee landing page displays the list of applications waiting for processing. Use the search filters on the page to find specific applications from the list.

Click on the **Application Number** hyperlink to open the application.

Scroll through the application details and review the details.

Click on the **Take Action** button and click on the **Verify and Forward** option if all details are found complete and satisfactory.

![](/files/-MgiG_BCiljqCojHyp6P)

Select the **Assignee Name**. The application will be forwarded to the selected assignee for approval.

In case, the documents and details are found incomplete or missing, click on **Send Back to Citizen** option. This will send back the application to the citizen for necessary action.

Click on the **Reject** option if the application details are found inaccurate. This will reject the application.

Click on **Send Back** option to send the application back to the previous employee (document verifier in this case) for further action.


# Approve Applications

Log in with Approver credentials.

The employee landing page displays the list of applications waiting for processing. Use the search filters on the page to find specific applications from the list.

Click on the **Application Number** hyperlink to open the application.

Scroll through the application details and review the details.

Click on the **Take Action** button and click on the **Approve** option if all documents and details are found complete and satisfactory. The trade license is approved and a Trade License certificate is issued to the applicant.

![](/files/-MgiG_BE_N9P9GyDvw_1)

Click on the **Reject** option if the application details are found inaccurate. This will reject the application.

![](/files/-MgiG_BGzrxNhLn7XpVz)

Click on **Send Back** option to send the application back to the previous employee (field inspector in this case) for further action.

The TL application is approved and the TL Certificate is issued to the applicant. Click on the **Download** or **Print** button to download or print the TL Certificate.


# Local Business License - Master Data Templates

This page provides configuration details for TL master data templates

## Introduction

The Local Business License Issuing application makes the process of obtaining a business license easy, smooth, and transparent. The module removes the need for manual processing and streamlines the key business license management functions to provide a better user experience.

## Module Features

The module enables citizens to -

1. Apply for a new trade license or renew an existing trade license.
2. Upload all the relevant documents required for the license.
3. Make payment for the Trade License (New/Renewal) fee using the online payment gateway.
4. Receive notifications and alerts by email or SMS for new application status updates and pending renewals.
5. Download Trade License, Payment & Acknowledgement Receipts online.

The module enables employees to -

1. Create flexible role-based workflows.
2. Configure license fee calculation logic.
3. View custom dashboards for module statistics.
4. Filter search results using advanced configurable search parameters.

## Module Ontology

### State Level <a href="#state-level" id="state-level"></a>

1. [Trade Category](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-category)
2. [Trade Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-type)
3. [Trade Sub Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type)
4. [Trade License Documents Attachment](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-license-document-attachment)
5. [Structure Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/structure-type)
6. [Structure Subtype](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/structure-sub-type)

### ULB Level <a href="#ulb-level" id="ulb-level"></a>

1. [Trade License Fee](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-license-fee)

## Module Reports

1. Receipt Register
2. Application Status
3. Cancelled Receipt Register
4. ULBwise Collection Report
5. ULBwise Application Status


# Trade Type

## Introduction <a href="#introduction" id="introduction"></a>

Once the [Trade Categories](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-category) are defined, the next task is to -

* Define Trade Types
* Map Trade Category to listed Trade Types

The Trade Type can be defined as the next (2nd) level classification of Trade. There can be multiple trade types and the list may vary from one State/ULB to another.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No. | Trade Type Code\*    | Trade Type Name\* (In English) | Trade Type Name\* (In Local Language) | Trade Category Code\* |
| ------- | -------------------- | ------------------------------ | ------------------------------------- | --------------------- |
| 1       | TRADE\_TYPE\_MEDICAL | Hospital                       | अस्पताल                               | TC1                   |
| 2       | TRADE\_TYPE\_HOTEL   | Hotels                         | होटल                                  | TC2                   |

The table above contains sample Trade Type data.

## Procedure <a href="#procedure" id="procedure"></a>

### Data Definition <a href="#data-definition" id="data-definition"></a>

| Sr. No. | Column Name                         | Data Type    | Data Size | Is Mandatory? | Description                                                                                                                                                                              |
| ------- | ----------------------------------- | ------------ | --------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Trade Type Code                     | Alphanumeric | 64        | Yes           | The Code assigned to the Trade Type. Eg: TRADE\_TYPE\_MEDICAL is assigned to Hospitals                                                                                                   |
| 3       | Trade Type Name (In English)        | Text         | 256       | Yes           | Name of the Trade Type in English. Eg: Goods, Services etc.                                                                                                                              |
| 3       | Trade Type Name (In Local Language) | Text         | 256       | Yes           | Name of the Trade Type in Local Language (as decided). Eg: Service is described as “सर्विस” in Hindi                                                                                     |
| 4       | Trade Category Code                 | Reference    | 64        | Yes           | The Code assigned to the [Trade Category](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-category). Eg: TC1 For Goods, TC2 for Services |

### Steps to fill data <a href="#steps-to-fill-data" id="steps-to-fill-data"></a>

1. Download the data template attached to this page.
2. Refer to the ‘Data Definition’ section of this document to learn more about the template sheet, data type, size, and definitions.
3. Select the relevant Trade Category Code from the available drop-down list of Trade Category. This will map the listed Trade Type to the corresponding Trade Category.
4. Enter a unique Trade Type Code to identify the type of trade.
5. Enter a Trade Type Name (In English).
6. Enter the Trade Type Name (In Local Language).

## Checklist <a href="#checklist" id="checklist"></a>

The checklist contains a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

This checklist covers the activities which are specific to the entity.

| Sr. No. | Checklist Parameter                                                            | Example                                                       |
| ------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| 1       | The format of the Trade Type Code defined should be alphanumeric and unique    | <p>TRADE\_TYPE\_MEDICAL</p><p>TRADE\_TYPE\_HOTELS</p>         |
| 2       | Trade Type Name (in either language) should not contain any special characters | <p>Hospital: \[Allowed]</p><p>#Hospital! : \[Not allowed]</p> |

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/CaTpf0a9dhBsnSpJpTH3" %}

{% file src="/files/aw1J71fiHVmqAPZUGlYK" %}


# Trade Sub Type

## Introduction <a href="#introduction" id="introduction"></a>

Trade Type can be further sub-classified into Trade Sub Type depending on the trade ontology existing in the ULBs or States. Hence, Hotels can be further classified into Dhabas in North India or Udupis in South India.

Once the[ Trade Type(s)](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-type) are defined, the next task is to -

* Define Trade Sub Types
* Map Trade Types to corresponding Trade Sub Types

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No. | Trade Sub Type Code\*  | Trade Sub Type Name\* (In English) | Trade Sub Type Name\* (In Local Language) | Trade Type Code\*    |
| ------- | ---------------------- | ---------------------------------- | ----------------------------------------- | -------------------- |
| 1       | TRADE\_SUBTYPE\_CLINIC | Clinic                             | क्लिनिक                                   | TRADE\_TYPE\_MEDICAL |
| 2       | TRADE\_SUBTYPE\_DHABA  | Dhaba                              | ढाबा                                      | TRADE\_TYPE\_HOTEL   |

The table above contains sample data.

## Procedure <a href="#procedure" id="procedure"></a>

### Data Definition <a href="#data-definition" id="data-definition"></a>

| Sr. No. | Column Name                             | Data Type    | Data Size | Is Mandatory? | Description                                                                                                                                                                                    |
| ------- | --------------------------------------- | ------------ | --------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Trade Sub Type Code                     | Alphanumeric | 64        | Yes           | The Code assigned to the Trade Sub Type. Eg: TRADE\_TYPE\_Dhaba is assigned to Hotels                                                                                                          |
| 2       | Trade Sub Type Name (In English)        | Text         | 256       | Yes           | Name of the Trade Sub Type in English. Eg: Clinic                                                                                                                                              |
| 3       | Trade Sub Type Name (In Local Language) | Text         | 256       | Yes           | Name of the Trade Sub Type in Local Language (as decided). Eg: Dhaba is described as “ढाबा” in Hindi                                                                                           |
| 4       | Trade Type Code                         | Reference    | 64        | Yes           | The Code assigned to the [Trade Type.](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-type) Eg: TRADE\_TYPE\_MEDICAL is assigned to Hospitals |

### Steps to fill data <a href="#steps-to-fill-data" id="steps-to-fill-data"></a>

1. Download the data template attached to this page.
2. Refer to the ‘Data Definition’ section of this document to learn more about the template sheet, data type, size, and definitions.
3. Select the relevant Trade Type Code from the Trade Type master data. This will map the listed Trade Sub Type to the selected Trade Type.
4. Enter a unique value for Trade Sub Type Code.
5. Enter the English name for Trade Sub Type Name (English).
6. Enter the local name for the Trade Sub Type Name (Local Language).

## Checklist <a href="#checklist" id="checklist"></a>

The checklist contains a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

This checklist covers the activities which are specific to the entity.

| Sr. No. | Checklist Parameter                                                            | Example                                                   |
| ------- | ------------------------------------------------------------------------------ | --------------------------------------------------------- |
| 1       | The format of the Trade Sub Type Code defined should be text and unique        | TRADE\_SUBTYPE\_CLINIC                                    |
| 2       | Trade Type Name (in either language) should not contain any special characters | <p>Clinic: \[Allowed]</p><p>#Clinic! : \[Not allowed]</p> |

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/CaTpf0a9dhBsnSpJpTH3" %}

{% file src="/files/oalJ5l2SD9qnqRyYX2zx" %}


# Trade Category

## Introduction <a href="#introduction" id="introduction"></a>

The Trade Category List can be defined as the primary or the 1st level classification “head” for trade(s) defined at a ULB/State Level.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr.No. | Trade Category Code\* | Trade Category Name\* (In English) | Trade Category Name\* (In Local Language) |
| ------ | --------------------- | ---------------------------------- | ----------------------------------------- |
| 1      | TC1                   | Goods                              | सामग्री                                   |
| 2      | TC2                   | Services                           | सर्विस                                    |

The table above contains sample Trade Category data.

## Procedure <a href="#procedure" id="procedure"></a>

### Data Definition <a href="#data-definition" id="data-definition"></a>

| Sr. No. | Column Name                             | Data Type  | Data Size | Is Mandatory? | Description                                                                                              |
| ------- | --------------------------------------- | ---------- | --------- | ------------- | -------------------------------------------------------------------------------------------------------- |
| 1       | Trade Category Code                     | Alphameric | 64        | Yes           | The Code assigned to the Trade Category. Eg: TC1 For Goods, TC2 for Services                             |
| 2       | Trade Category Name (In English)        | Text       | 256       | Yes           | Name of the Trade Category in English. Eg: Goods, Services etc.                                          |
| 3       | Trade Category Name (In Local Language) | Text       | 256       | Yes           | Name of the Trade Category in Local Language (as decided). Eg: Service is described as “सर्विस” in Hindi |

### Steps to fill data <a href="#steps-to-fill-data" id="steps-to-fill-data"></a>

1. Download the data template attached to this page.
2. Refer to the ‘Data Definition’ section of this document to learn more about the template sheet, data type, size, and definitions.
3. Enter a unique Trade Category Code for each trade head.
4. Enter the Trade Category Name. Some trade categories are already defined in the master. Add new categories as required.
5. Enter the Trade Category Name (Local Language).

## Checklist <a href="#checklist" id="checklist"></a>

The checklist contains a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

This checklist covers the activities which are specific to the entity.

| Sr. No. | Checklist Parameter                                                                | Example                                                 |
| ------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------- |
| 1       | The format of the Trade Category Code defined should be alphanumeric and unique    | <p>TC1: Goods</p><p>TC2: Services</p>                   |
| 2       | Trade Category Name (In either Language) should not contain any special characters | <p>Goods: \[Allowed]</p><p>#Goods! : \[Not allowed]</p> |

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/CaTpf0a9dhBsnSpJpTH3" %}

{% file src="/files/aw1J71fiHVmqAPZUGlYK" %}


# Trade License Fee

## Introduction <a href="#introduction" id="introduction"></a>

Once the Trade Ontology is defined, the next step is to allocate the license fee associated with the Trades.

Dependent on the Trade Classification Level ([Types](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-type)/ [Subtypes](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type)), the fee allocated might be the same across the Sate or could vary from ULB to ULB. There could be a distinct fee(s) for two different types of applications (new and renewal).

Following are the key tasks to be executed :

* Allocate the License Fee according to Trade Classification Level (Types/Subtypes).
* Map the License fee with the respective Trade Classification Level.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No | Trade Sub Type Code\* | Trade Sub Type Name (In English) | New License Fee\* | Renewal License Fee\* | UOM     | UOM From | UOM To |
| ------ | --------------------- | -------------------------------- | ----------------- | --------------------- | ------- | -------- | ------ |
| 1      | TRADE\_SMALL\_BAKERY  | Small Bakery                     | 2500              | 2000                  | Workers | 1        | 20     |
| 2      | TRADE\_SMALL\_BAKERY  | Small Bakery                     | 3000              | 2500                  | Workers | 21       | 30     |
| 2      | TRADE\_MED\_BAKERY    | Medium Bakery                    | 5000              | 4500                  | Workers | 1        | 30     |

The table above contains sample data.

## Procedure <a href="#procedure" id="procedure"></a>

| Sr. No. | Column Name                      | Data Type | Data Size | Is Mandatory? | Description                                                                                                                                                                                         |
| ------- | -------------------------------- | --------- | --------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Trade Sub Type Code              | Reference | 64        | Yes           | The Code assigned to the [Trade Sub Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type). Eg: TRADE\_SMALL\_BAKERY is assigned to Bakery |
| 2       | Trade Sub Type Name (In English) | Text      | 256       | Yes           | Name of the Trade Sub Type in English. Eg: Small Bakery                                                                                                                                             |
| 3       | New License Fee                  | Decimal   | (6,2)     | Yes           | The fee charged when the license applied for the respective trade for the first time.                                                                                                               |
| 4       | Renewal License Fee              | Decimal   | (6,2)     | Yes           | The fee charged when the license applied for the respective trade for the renewal.                                                                                                                  |
| 5       | UOM                              | Text      | 64        | No            | The Units of Measurement” associated with the Trade. Eg: Workers is the UOM associated with the trade “Bakery”                                                                                      |
| 6       | UOM From                         | Integer   | 6         | No            | Initial Range from which the “Units of Measurement” is applicable for a Trade                                                                                                                       |
| 7       | UOM To                           | Integer   | 6         | No            | Final Range to which the “Units of Measurement” is applicable to a Trade                                                                                                                            |

### How to fill data <a href="#how-to-fill-data" id="how-to-fill-data"></a>

1. Download the data template attached to this page.
2. Get a good understanding of all the headers in the template sheet, their data type, size, and definitions by referring to the ‘Data Definition’ section of this document.
3. Identify the “[Trade Sub Types](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type)” that exists at a ULB/ State level.
4. Collect the above information and feed it below the “Trade Sub Type Name” column accordingly. The Description of Trade Sub Type Name must be provided as per the language specified in the respective column.
5. Add the “Trade Sub Type Code” respectively against the identified trade type(s).
6. Fill in the New License Fee & New Renewal Fee accordingly. The New License Fee & Renewal Fee can be the same as well as distinct, depending on the by-laws/ mandate followed by the State/ULB.
7. Fill in the fields related to Units of Measurement (UOM Unit, From/To) for the available trades only.

## Checklist <a href="#checklist" id="checklist"></a>

The checklist is a set of activities to be performed once the data is filled into a template to ensure data type, size, and format of data is as per the expectation. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

This checklist covers the activities which are specific to the entity.

| Sr. No. | Checklist Parameter                                                            | Example                                                                |
| ------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| 1       | Trade Type Name (In either Language) should not contain any special characters | <p>Small Bakery: \[Allowed]</p><p>#Small\_Bakery! : \[Not allowed]</p> |

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/CaTpf0a9dhBsnSpJpTH3" %}

{% file src="/files/oalJ5l2SD9qnqRyYX2zx" %}


# Structure Type

## Introduction <a href="#introduction" id="introduction"></a>

The structure type is the first level of classification of the premises where the trade has to be established and conducted. This is mostly used as management information in the trade detail.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No. | Code\*    | Structure Type\* (In English) | Structure Type\* (In Local Language) |
| ------- | --------- | ----------------------------- | ------------------------------------ |
| 1       | IMMOVABLE | Immovable                     | अचल                                  |
| 2       | MOVABLE   | Movable                       | चल                                   |

The table above contains sample data.

## Procedure <a href="#procedure" id="procedure"></a>

### Data Definition <a href="#data-definition" id="data-definition"></a>

| Sr. No. | Column Name                          | Data Type    | Data Size | Is Mandatory? | Definition/ Description                                  |
| ------- | ------------------------------------ | ------------ | --------- | ------------- | -------------------------------------------------------- |
| 1       | Code                                 | Alphanumeric | 64        | Yes           | Unique code to identify the records uniquely             |
| 2       | Structure Type\* (In English)        | Text         | 256       | Yes           | Structure type in English                                |
| 3       | Structure Type\* (In Local Language) | Text         | 256       | Yes           | Structure type in local language e.g. Hindi, Telugu etc. |

### Steps to fill data <a href="#steps-to-fill-data" id="steps-to-fill-data"></a>

1. Download the data template attached to this page.
2. Refer to the ‘Data Definition’ section of this document for more details on data type, size, and definitions.
3. Contact the person who shared this template with you to discuss and clear your doubts.
4. Enter the relevant structure types.
5. Verify the data once again by going through the checklist and making sure that each and every point mentioned in the checklist is covered.

## Checklist <a href="#checklist" id="checklist"></a>

The checklist is a set of activities to be performed once the data is filled into a template to ensure data type, size, and format of data is as per specifications. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

A separate entity-specific checklist is not needed for this entity data template.

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/FN4USmLehe3Fa3eMM906" %}

{% file src="/files/P0Idf6xla227ULFJzJja" %}


# Structure Sub Type

## Introduction <a href="#introduction" id="introduction"></a>

Structure sub type is the second level of classification of the premises where the trade has to be established and conducted. This is mostly used as management information in the trade detail.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No. | Code\* | Structure Sub Type\* (In English) | Structure Sub Type\* (In Local Language) | Structure Type Code\* |
| ------- | ------ | --------------------------------- | ---------------------------------------- | --------------------- |
| 1       | PUCCA  | Pucca                             | पक्का                                    | IMMOVABLE             |
| 2       | KUTCHA | Kutcha                            | कच्चा                                    | IMMOVABLE             |
| 3       | HDV    | Hand Driven Vehicle               | हाथ चालित वाहन                           | MOVABLE               |
| 4       | MDV    | Motor-Driven Vehicle              | मोटर चालित वाहन                          | MOVABLE               |

The table above contains sample data.

## Procedure <a href="#procedure" id="procedure"></a>

### Data Definition <a href="#data-definition" id="data-definition"></a>

| Sr. No. | Column Name                              | Data Type    | Data Size | Is Mandatory? | Definition/ Description                                                                                                                                                                 |
| ------- | ---------------------------------------- | ------------ | --------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Code                                     | Alphanumeric | 64        | Yes           | Unique code to identify each and every record uniquely                                                                                                                                  |
| 2       | Structure Sub Type\* (In English)        | Text         | 256       | Yes           | Structure sub type in English                                                                                                                                                           |
| 3       | Structure Sub Type\* (In Local Language) | Text         | 256       | Yes           | Structure sub type in local language e.g. in Hindi, Telugu etc.                                                                                                                         |
| 4       | Structure Type Code\*                    | Reference    | 64        | Yes           | Unique code of structure type to establish the mapping with [Structure Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/structure-type)​ |

### Steps to fill data <a href="#steps-to-fill-data" id="steps-to-fill-data"></a>

1. Download the data template attached to this page.
2. Refer to the ‘Data Definition’ section of this document for more details on data type, size, and definitions.
3. Contact the person who shared this template with you to discuss and clear your doubts.
4. Enter the relevant structure sub types with its proper mapping with structure type.
5. Verify the data once again by going through the checklist and making sure that each and every point mentioned in the checklist is covered.

## Checklist <a href="#checklist" id="checklist"></a>

The checklist is a set of activities to be performed once the data is filled into a template to ensure data type, size, and format of data is as per specifications. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                                | Example                                                                                                                      |
| ------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of. | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

A separate entity-specific checklist is not needed for this entity data template.

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/vaI6C2Fteu8lc03vQSvz" %}

{% file src="/files/P0Idf6xla227ULFJzJja" %}


# Trade License Document Attachment

## Introduction <a href="#introduction" id="introduction"></a>

Along with the [rates](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-license-fee), the Trade License application process does require certain documents as an attachment of proof. The proof can be defined by a set of documents ranging from

* Identification Proof (Drivers License/ Voter Card/ Adhaar/ Pan etc.)
* Trade Premises Proof (Lease Agreement, Electricity Bills, etc).
* Misc Documents (Affidavit, Self- Declaration, etc).

The Number and the Documents required could vary across the State, ULB(s), and might be dependent on Trade Subtypes, all of which are totally configurable on DIGIT.

## Data Table <a href="#data-table" id="data-table"></a>

| Sr. No. | \*Trade Subtype Code | \*Trade Subtype Name (In English) | \*Application Type | \*Document 1 | \*Document 2 |
| ------- | -------------------- | --------------------------------- | ------------------ | ------------ | ------------ |
| 1       | TRADE\_SMALL\_BAKERY | Small Bakery                      | New                | PAN/VOTER ID | LAND LEASE   |
| 2       | TRADE\_SMALL\_BAKERY | Small Bakery                      | Renewal            | PAN/VOTER ID | ELEC BILL    |

The table above contains sample data.

## Procedure <a href="#procedure" id="procedure"></a>

| Sr. No. | Column Name                   | Data Type | Data Size | Is Mandatory? | Description                                                                                                                                                                                                                     |
| ------- | ----------------------------- | --------- | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1       | Trade Sub Type Code           | Reference | 64        | Yes           | The Code assigned to the[ Trade Sub Type](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type). Eg: TRADE\_SMALL\_BAKERY is assigned to Bakery                             |
| 2       | Trade Sub Type Name (English) | Text      | 256       | Yes           | Name of the Trade Sub Type in English Eg: Clinic                                                                                                                                                                                |
| 3       | Application Type              | Text      | 256       | Yes           | Type of application for which the documents related to trade are configured. It can either be new or renewal                                                                                                                    |
| 4       | Document 1                    | Reference | 256       | Yes           | The primary document required as a verification parameter. Refer to the [Standard Document List](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/standard-document-list)​   |
| 5       | Document 2                    | Reference | 256       | Yes           | The Secondary Document required as a verification parameter. Refer to the [Standard Document List](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/standard-document-list)​ |

### How to fill data <a href="#how-to-fill-data" id="how-to-fill-data"></a>

1. Download the data template attached to this page.
2. Get a good understanding of all the headers in the template sheet, their data type, size, and definitions by referring to the ‘Data Definition’ section of this document.
3. In case of any doubt, please reach out to the person who has shared this template with you to discuss and clear your doubts.
4. Identify the “[Trade Sub Types](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates/trade-sub-type)” that exists at a ULB/ State level.
5. Collect the above information and feed it below the “Trade Sub Type Name” column accordingly. The Description of Trade Sub Type Name must be provided as per the language specified in the respective column.
6. Add the “Trade Sub Type Code” respectively against the identified trade type(s).
7. Fill in the \*Document 1 & \*Document 2 columns respectively.

## Checklist <a href="#checklist" id="checklist"></a>

The checklist is a set of activities to be performed once the data is filled into a template to ensure data type, size, and format of data is as per the expectation. These activities have been divided into 2 groups as given below.

### Common Checklist <a href="#common-checklist" id="common-checklist"></a>

This checklist covers all the activities which are common across the entities.

| Sr. No. | Checklist Parameter                                                               | Example                                                                                                                      |
| ------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1       | Make sure that each and every point in this reference list has been taken care of | ​[Checklist](https://docs.digit.org/configure-digit/configuring-master-data-templates/module-setup/common-config/checklist)​ |

### Entity Specific Checklist <a href="#entity-specific-checklist" id="entity-specific-checklist"></a>

This checklist covers the activities which are specific to the entity.

| Sr. No. | Checklist Parameter                                                                | Example                                                                |
| ------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| 1       | Trade Sub Type Name (In either Language) should not contain any special characters | <p>Small Bakery: \[Allowed]</p><p>#Small\_Bakery! : \[Not allowed]</p> |

## Attachments <a href="#attachments" id="attachments"></a>

{% file src="/files/CaTpf0a9dhBsnSpJpTH3" %}

{% file src="/files/oalJ5l2SD9qnqRyYX2zx" %}


# Local Business License Service Configuration

## Overview <a href="#overview" id="overview"></a>

This service is used to issue a license to the user after verification. The service is designed in such a way that it can be used to serve different type of licenses. Currently used to issue trade licenses, perform stakeholder registration and issue lockdown pass. The service is integrated with workflow where we can define the steps for approval of the application. Once the application is approved the license is generated.

## Pre-requisites <a href="#pre-requisites" id="pre-requisites"></a>

Before you proceed with the documentation, make sure the following pre-requisites are met -

* Java 8
* Kafka server is up and running
* egov-persister service is running and has tl-services persister config path added in it
* PSQL server is running and database is created

## Key Functionalities <a href="#key-functionalities" id="key-functionalities"></a>

* Used for license generations in trade licenses, stakeholder registration and issue lockdown pass
* Define roles to applicants on successful application to access Building Plan Approval services at the time of stakeholder registration
* Generate application number and license number
* Support workflows
* Provide notification on various status changes for an application

## Interaction Diagram <a href="#interaction-diagram" id="interaction-diagram"></a>

![](/files/-MiL2g8pB1TDYXITmaG3)

## Deployment Details <a href="#deployment-details" id="deployment-details"></a>

1. Add MDMS configs required for Trade License and BPA stakeholder registration and restart MDMS service
2. Deploy the latest version of tl-services service
3. Add tl-service persister yaml path in persister configuration and restart persister service
4. Add Role-Action mapping for API’s
5. Create businessService (workflow configuration) according to trade license and stakeholder registration
6. Add tl-service indexer yaml path in indexer service configuration and restart indexer service

## Configuration Details <a href="#configuration-details" id="configuration-details"></a>

Following application properties in the Trade License service are configurable.

| Property                                      | Value                                                                                                                                 | Remarks                                                      |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| egov.idgen.tl.applicationNum.format           | PB-TL-\[cy:yyyy-MM-dd]-\[SEQ\_EG\_TL\_APL]                                                                                            | The format of the TL application number                      |
| egov.idgen.tl.licensenumber.format            | PB-TL-\[cy:yyyy-MM-dd]-\[SEQ\_EG\_PT\_LN]                                                                                             | The format of the TL license number                          |
| egov.idgen.bpa.applicationNum.format          | PB-SK-\[cy:yyyy-MM-dd]-\[SEQ\_EG\_TL\_APL]                                                                                            | The format of the Stake holder application number            |
| egov.idgen.bpa.licensenumber.format           | PB-SK-\[cy:yyyy-MM-dd]-\[SEQ\_EG\_PT\_LN]                                                                                             | The format of the Stake holder license number                |
| egov.tl.max.limit                             | 100                                                                                                                                   | Max number of records to be returned                         |
| citizen.allowed.search.params                 | tenantId, applicationNumber, limit, offset, licenseNumbers                                                                            | The search parameters on which citizen can search            |
| employee.allowed.search.params                | tenantId, applicationNumber, applicationType, status, mobileNumber, fromDate, toDate, licenseNumbers, oldLicenseNumber, limit, offset | The search parameters on which employee can search           |
| persister.save.tradelicense.topic             | save-tl-tradelicense                                                                                                                  | The name of kafka topic on which create request is published |
| persister.update.tradelicense.topic           | update-tl-tradelicense                                                                                                                | The name of kafka topic on which update request is published |
| persister.update.tradelicense.workflow\.topic | update-tl-workflow                                                                                                                    | The name of kafka topic on which update request is published |

## Integration <a href="#integration" id="integration"></a>

### Integration Scope <a href="#integration-scope" id="integration-scope"></a>

The trade-license service is currently used to issue trade licenses, perform stakeholder registration and issue lockdown pass.

### Integration Benefits <a href="#integration-benefits" id="integration-benefits"></a>

* Provide backend support for the different license registration process.
* Mseva and SMS notifications on application status changes.
* The elastic search index for creating visualizations and Dashboards.
* Bpa Stakeholder registration provides new roles to the user to access the Building Plan Approval system.
* Supports workflow which is configurable

### Steps to Integration <a href="#steps-to-integration" id="steps-to-integration"></a>

1. To integrate, host of tl-services service should be overwritten in the helm chart.
2. {servicename}/\_create/ \_create should be added as the create endpoint for creating any license in the system
3. {servicename}/\_search/ \_search should be added as the search endpoint. This method handles all requests to search existing records depending on different search criteria
4. {servicename}/\_update/ \_update should be added as the update endpoint. This method is used to update fields in existing records or to update the status of the application based on workflow.

## Reference Docs <a href="#reference-docs" id="reference-docs"></a>

### Doc Links <a href="#doc-links" id="doc-links"></a>

{% file src="/files/-MWUKL0lgMPk45Rm6g-e" %}

{% file src="/files/-MWUKL0oRoXDLnlAkaCi" %}

{% content-ref url="/pages/rN4SIdKA5N4lFD6D8yXN" %}
[BPA Stakeholder Registration](/local-governance/access/local-governance-stack/online-building-plan-approval-system-obpas/obpas-service-configuration/bpa-stakeholder-registration)
{% endcontent-ref %}

| Title                                     | Link                                                                                                                                 |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Local Setup                               | [LOCALSETUP.md](https://github.com/egovernments/core-services/blob/4a74fd3be04ab0a2fe0641f10b57b7e9b9f82aff/egov-user/LOCALSETUP.md) |
| API Swagger Documentation (Trade License) | [Swagger Documentation TL](https://raw.githubusercontent.com/egovernments/egov-services/master/docs/common/contracts/v1-0-0.yml)     |

### API List <a href="#api-list" id="api-list"></a>

In all below endpoints if the service name is BPAREG it is treated as a stakeholder registration application and if it is TL or if it is absent then the application is treated as trade license application.

Stakeholder registration APIs:- <https://www.getpostman.com/collections/d18b79ccfb69ee8bb526>

Trade-License APIs:- <https://www.getpostman.com/collections/99f98723c45f97024831>

| API                                       | Description                                                                                                                                                                                                                                                                             |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {servicename}/\_create, \_create          | This API is used to create an application for the license in the system. Whenever an application is created an application number is generated and assigned to the application for future reference.                                                                                    |
| {servicename}/\_search, /\_search         | This API is used to search the applications in the system based on various search parameters like mobile number, the application number, status etc.                                                                                                                                    |
| {servicename}/\_update, \_update          | <p>The \_update API is used to update the application information or to forward the application from one state to another.</p><p>In the case of the stakeholder registration if the application reaches the last stage the role depending on the license type is given to the user.</p> |
| {servicename}/{jobname}/\_batch, /\_batch | Searches trade licenses that are expiring and send a reminder SMS to owner's of the licenses                                                                                                                                                                                            |


# Local Business License Issuing Service - Steps To Upload Data

## 1. Add Tenant/Urban Local Body Data

To onboard a new Urban Local Body (ULB) or tenant for the **Local Business License Issuing Service** modules, follow the steps given below:

{% stepper %}
{% step %}

### Add data in MDMS&#x20;

Refer to the table below to find the location for specific data types and its description.

<table><thead><tr><th width="154">Reference from Sample Data Load</th><th width="139">Data</th><th width="149">Location</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n">Tenants</a></td><td>Tenant Details</td><td><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/tenant/tenants.json">tenant/tenants.json</a></td><td>To show the tenant at login screen</td></tr><tr><td><br></td><td><br></td><td><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/tenant/citymodule.json#L95">tenant/citymodule.json</a></td><td>To enable ulb to create application,add tenant in TL module</td></tr><tr><td><a href="https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n">TL Trade Type</a></td><td>Trade Type (Business Units) information</td><td><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/TradeType.json">TradeLicense/TradeType.json</a></td><td>To add Business Units</td></tr><tr><td><a href="https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n">Property Type</a></td><td>Create Property</td><td><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/PropertyTax/PropertyType.json">ULBNAME/PropertyTax/PropertyType.json</a></td><td>To create new property.From citizen end,in create property screen,provide property Type</td></tr><tr><td><a href="https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n">Owership Type</a></td><td>Property Ownership Details</td><td><p><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/common-masters/OwnerShipCategory.json">ULBNAME/common-masters/OwnerShipCategory.json</a></p><p><br></p></td><td>To provide type of ownership in create property screen</td></tr><tr><td><a href="https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n">Owner Type</a></td><td>Property Owner Type</td><td><a href="https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/PropertyTax/OwnerType.json">ULBNAME/PropertyTax/OwnerType.json</a></td><td>To provide owner type in create property screen</td></tr></tbody></table>
{% endstep %}

{% step %}

### Add boundary data

* Add boundary data specific to the tenant (Refer to [sample data](https://docs.google.com/document/d/1rqLjwIzIXriMgB4CV2mRPsfK29dh2PH6oJuhStFG4is/edit?tab=t.0#heading=h.ystac415z2n)). Reference [boundary data sample](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/ca.alameda/egov-location/boundary-data.json).&#x20;
  {% endstep %}

{% step %}

### Provide ID Format&#x20;

* Reference [ID Format sample](https://github.com/egovernments/egov-mdms-data/blob/d6c3ccde12f76477987214ea4418e8bf930ea47d/data/ca/common-masters/IdFormat.json#L18).
  {% endstep %}

{% step %}

### Provide Gender Type

* Reference [Gender Type sample](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/common-masters/GenderType.json).&#x20;
  {% endstep %}

{% step %}

### Input Other Data

* Reference - sample data for [Penalty](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/Penalty.json), [Rebate](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/Rebate.json), [FinancialYear](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/egf-master/FinancialYear.json#L62-L73), [TaxPeriod](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/BillingService/TaxPeriod.json)
  {% endstep %}

{% step %}

### Restart MDMS Service

* Restart the mdms service and check the status in ui. The tenant is added in ui.
* Create [login credentials](#login-credentials) for relevant users.
* Push the localisations as provided in [API collection here](https://api.postman.com/collections/29184917-baf35865-01df-44ac-9cf7-0100b84e3336?access_key=PMAT-01JCJBSZN545HRZA726AYPMV6D).  &#x20;
* Push the billing-slab of new tenant mentioned in Sample Data - [TL Billing Slab](#id-2.-load-billing-slab-data).
* Push the [TL workflow](#id-3.-load-workflows).
  {% endstep %}
  {% endstepper %}

## 2. Load Billing Slab Data

In TL, there are two types of billing slab, one is according to the tradeType and the other way is accessoryCategory.

Add following data in MDMS for billing slab push and restart MDMS:

* [Application Type](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/ApplicationType.json)
* [Structure Type](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/common-masters/StructureType.json)
* [Trade Type](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/TradeType.json)
* [Accessory Category](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/TradeLicense/AccessoriesCategory.json)
* [UOM](https://github.com/egovernments/egov-mdms-data/blob/usa-demo/data/ca/common-masters/UOM.json)

#### 1. tradeType

Provide different combinations of UOM rates - fromUOM and toUOM according to tradeType by taking accessoryCategory as null.

Example - From UOM : 0.00 , To UOM : 10,000.00 – Rate : 500.00

```
// {
            "tenantId": "ca.alameda",
            "licenseType": "PERMANENT",
            "applicationType": "NEW",
            "structureType": "IMMOVABLE.PUCCA",
            "tradeType": "GOODS.HEALTHCARE.DENTALLABSERVICES",
            "accessoryCategory": null,
            "type": "FLAT",
            "uom": "GROSSUNITS",
            "fromUom": "0",
            "toUom": "10000",
            "rate": "500"
        }
```

#### 2. accessoryCategory

Provide different combinations of UOM rates - fromUOM and toUOM according to accessoryCategory by taking tradeType as null.

Example - From UOM : 0.00 , To UOM : 10,000.00 – Rate : 200.00

```
//{
            "tenantId": "ca.alameda",
            "licenseType": "PERMANENT",
            "applicationType": "NEW",
            "structureType": "IMMOVABLE.PUCCA",
            "tradeType": null,
            "accessoryCategory": “ACC-1”,
            "type": "FLAT",
            "uom": "GROSSUNITS",
            "fromUom": "0",
            "toUom": "10000",
            "rate": "200"
        }
```

[API Collection](https://api.postman.com/collections/29184917-ee4f7d1e-e439-4d0a-a099-9fe775ba5e1e?access_key=PMAT-01JCJDGBMHZMQ52ABWZ97080K0)

## 3. Load Workflows

```
//[
  {
    "tenantId": "ca",
    "businessService": "DIRECTRENEWAL",
    "business": "tl-services",
    "businessServiceSla": 172800000,
    "states": [
      {
        "tenantId": "ca",
        "sla": null,
        "state": null,
        "applicationStatus": "APPLIED",
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": null,
            "action": "INITIATE",
            "nextState": "PENDINGPAYMENT",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "PENDINGPAYMENT",
        "applicationStatus": "PENDINGPAYMENT",
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "PENDINGPAYMENT",
            "action": "PAY",
            "nextState": "APPROVED",
            "roles": [
              "CITIZEN",
              "TL_CEMP",
              "SYSTEM_PAYMENT"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "APPROVED",
        "applicationStatus": "APPROVED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      }
    ]
  },
  {
    "tenantId": "ca",
    "businessService": "EDITRENEWAL",
    "business": "tl-services",
    "businessServiceSla": 172800000,
    "states": [
      {
        "tenantId": "ca",
        "sla": null,
        "state": null,
        "applicationStatus": null,
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": null,
            "action": "INITIATE",
            "nextState": "INITIATED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "INITIATED",
        "applicationStatus": "INITIATED",
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "INITIATED",
            "action": "INITIATE",
            "nextState": "INITIATED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "INITIATED",
            "action": "APPLY",
            "nextState": "APPLIED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "APPLIED",
        "applicationStatus": "APPLIED",
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "APPLIED",
            "action": "FORWARD",
            "nextState": "FIELDINSPECTION",
            "roles": [
              "TL_DOC_VERIFIER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "APPLIED",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_DOC_VERIFIER"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "REJECTED",
        "applicationStatus": "REJECTED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "FIELDINSPECTION",
        "applicationStatus": "FIELDINSPECTION",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "FORWARD",
            "nextState": "PENDINGAPPROVAL",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "PENDINGAPPROVAL",
        "applicationStatus": "PENDINGAPPROVAL",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "PENDINGAPPROVAL",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "PENDINGAPPROVAL",
            "action": "APPROVE",
            "nextState": "PENDINGPAYMENT",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "PENDINGPAYMENT",
        "applicationStatus": "PENDINGPAYMENT",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "PENDINGPAYMENT",
            "action": "PAY",
            "nextState": "APPROVED",
            "roles": [
              "CITIZEN",
              "TL_CEMP",
              "SYSTEM_PAYMENT"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "PENDINGPAYMENT",
            "action": "ADHOC",
            "nextState": "PENDINGPAYMENT",
            "roles": [
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "APPROVED",
        "applicationStatus": "APPROVED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "APPROVED",
            "action": "CANCEL",
            "nextState": "CANCELLED",
            "roles": [
              "CITIZEN",
              "TL_CEMP",
              "SYSTEM_PAYMENT"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "CANCELLED",
        "applicationStatus": "CANCELLED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      }
    ]
  },
  {
    "tenantId": "ca",
    "businessService": "NewTL",
    "business": "tl-services",
    "businessServiceSla": 172800000,
    "states": [
      {
        "tenantId": "ca",
        "sla": null,
        "state": null,
        "applicationStatus": null,
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": null,
            "action": "INITIATE",
            "nextState": "INITIATED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "INITIATED",
        "applicationStatus": "INITIATED",
        "docUploadRequired": false,
        "isStartState": true,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "INITIATED",
            "action": "APPLY",
            "nextState": "APPLIED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "INITIATED",
            "action": "INITIATE",
            "nextState": "INITIATED",
            "roles": [
              "CITIZEN",
              "TL_CEMP"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "APPLIED",
        "applicationStatus": "APPLIED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "APPLIED",
            "action": "FORWARD",
            "nextState": "FIELDINSPECTION",
            "roles": [
              "TL_DOC_VERIFIER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "APPLIED",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_DOC_VERIFIER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "APPLIED",
            "action": "SENDBACKTOCITIZEN",
            "nextState": "CITIZENACTIONREQUIRED",
            "roles": [
              "TL_DOC_VERIFIER"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "REJECTED",
        "applicationStatus": "REJECTED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      },
      {
        "tenantId": "ca",
        "sla": 86400000,
        "state": "FIELDINSPECTION",
        "applicationStatus": "FIELDINSPECTION",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "FORWARD",
            "nextState": "PENDINGAPPROVAL",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "SENDBACK",
            "nextState": "APPLIED",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "FIELDINSPECTION",
            "action": "SENDBACKTOCITIZEN",
            "nextState": "CITIZENACTIONREQUIRED",
            "roles": [
              "TL_FIELD_INSPECTOR"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": 43200000,
        "state": "PENDINGAPPROVAL",
        "applicationStatus": "PENDINGAPPROVAL",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "PENDINGAPPROVAL",
            "action": "REJECT",
            "nextState": "REJECTED",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "PENDINGAPPROVAL",
            "action": "APPROVE",
            "nextState": "PENDINGPAYMENT",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "PENDINGAPPROVAL",
            "action": "SENDBACK",
            "nextState": "FIELDINSPECTION",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": 43200000,
        "state": "PENDINGPAYMENT",
        "applicationStatus": "PENDINGPAYMENT",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "PENDINGPAYMENT",
            "action": "ADHOC",
            "nextState": "PENDINGPAYMENT",
            "roles": [
              "TL_CEMP"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "PENDINGPAYMENT",
            "action": "PAY",
            "nextState": "APPROVED",
            "roles": [
              "CITIZEN",
              "TL_CEMP",
              "SYSTEM_PAYMENT"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "APPROVED",
        "applicationStatus": "APPROVED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": false,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "APPROVED",
            "action": "CANCEL",
            "nextState": "CANCELLED",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "APPROVED",
            "action": "EXPIRE",
            "nextState": "EXPIRED",
            "roles": [
              "SYSTEM"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "APPROVED",
            "action": "MANUALEXPIRE",
            "nextState": "MANUALEXPIRED",
            "roles": [
              "TL_APPROVER"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "CANCELLED",
        "applicationStatus": "CANCELLED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "CITIZENACTIONREQUIRED",
        "applicationStatus": "CITIZENACTIONREQUIRED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": false,
        "isStateUpdatable": true,
        "actions": [
          {
            "tenantId": "ca",
            "currentState": "CITIZENACTIONREQUIRED",
            "action": "RESUBMIT",
            "nextState": "APPLIED",
            "roles": [
              "TL_CEMP"
            ],
            "active": true
          },
          {
            "tenantId": "ca",
            "currentState": "CITIZENACTIONREQUIRED",
            "action": "FORWARD",
            "nextState": "APPLIED",
            "roles": [
              "CITIZEN"
            ],
            "active": true
          }
        ]
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "MANUALEXPIRED",
        "applicationStatus": "MANUALEXPIRED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      },
      {
        "tenantId": "ca",
        "sla": null,
        "state": "EXPIRED",
        "applicationStatus": "EXPIRED",
        "docUploadRequired": false,
        "isStartState": false,
        "isTerminateState": true,
        "isStateUpdatable": false,
        "actions": null
      }
    ]
  }
]

```

[API Collection](https://api.postman.com/collections/29184917-cf82077a-8dd4-4b78-822f-90ee70b4811a?access_key=PMAT-01JCJH8MJMWYXNFZRXSVCKQT4R)

## Sample Data Load

* **Tenants**

| Code        | Name        | Description | Pincode                          | Logo ID                                                                                                   | Image ID    | Domain URL               | Type        | Twitter URL | Facebook URL | Email                 | Office Timings    | City               | Address | Contact Number | Helpline Number | District Name | District Tenant Code | Region Name | ULB Grade             | Longitude   | Latitude  | Shape File Location | Captcha | Code | DDR Name | Locality Code | Locality Name            |             |             |
| ----------- | ----------- | ----------- | -------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------- | ------------------------ | ----------- | ----------- | ------------ | --------------------- | ----------------- | ------------------ | ------- | -------------- | --------------- | ------------- | -------------------- | ----------- | --------------------- | ----------- | --------- | ------------------- | ------- | ---- | -------- | ------------- | ------------------------ | ----------- | ----------- |
| <p><br></p> | <p><br></p> | <p><br></p> | <p><br></p>                      | <p><br></p>                                                                                               | <p><br></p> | <p><br></p>              | <p><br></p> | <p><br></p> | <p><br></p>  | <p><br></p>           | Mon - Fri         | Sat                | Name    | Local Name     | District Code   | District Name | District tenant Code | Region Name | ULB Grade             | Longitude   | Latitude  | Shape File Location | Captcha | Code | DDR Name | Locality Code | Locality Name            | <p><br></p> | <p><br></p> |
| ca.alameda  | Alameda     | null        | \[14306,14307,14308,14309,14310] | <https://www.alamedaca.gov/files/assets/public/v/1/city_seal_final_website.jpg?dimension=pageimage&w=480> | null        | <https://www.csd.ca.gov> | CITY        | null        | null         | <Web.Info@csd.ca.gov> | 9.00 AM - 6.00 PM | 9.00 AM - 12.00 PM | Alameda | null           | null            | Alameda       | CA\_Alameda          | null        | Municipal Corporation | -122.241638 | 37.765205 | null                | null    | 2131 | null     | ALM001        | East End, West End       | 9876543210  | 9876543210  |
| ca.albany   | Albany      | null        | \[14306,14307,14308,14309,14310] | <https://www.alamedaca.gov/files/assets/public/v/1/city_seal_final_website.jpg?dimension=pageimage&w=480> | null        | <https://www.csd.ca.gov> | CITY        | null        | null         | <Web.Info@csd.ca.gov> | 9.00 AM - 6.00 PM | 9.00 AM - 12.00 PM | Albany  | null           | null            | Alameda       | CA\_Alameda          | null        | Municipal Corporation | -122.241648 | 37.765215 | null                | null    | 2132 | null     | ALM002        | Albany Hill, East Albany | 9876543211  | 9876543209  |

* **TL Trade Type**

| Name                | Code                               | UOM         | Document List                                     | Verification Document                                             | Active      | Type        | Validity Period |             |
| ------------------- | ---------------------------------- | ----------- | ------------------------------------------------- | ----------------------------------------------------------------- | ----------- | ----------- | --------------- | ----------- |
| <p><br></p>         | <p><br></p>                        | <p><br></p> | New                                               | Renewal                                                           | <p><br></p> | <p><br></p> | <p><br></p>     | <p><br></p> |
| Dental Lab Services | GOODS.HEALTHCARE.DENTALLABSERVICES | GROSSUNITS  | \["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO"] | \["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO", "OLDLICENCENO"] | <p><br></p> | true        | TL              | null        |
| Clothing Retail     | GOODS.RETAIL.CLOTHINGRETAIL        | GROSSUNITS  | \["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO"] | \["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO", "OLDLICENCENO"] | null        | true        | TL              | null        |

* **Property Type**

| Name                            | Property Type         |
| ------------------------------- | --------------------- |
| BUILTUP.OFFICE\_BUILDING        | Office Building       |
| BUILTUP.RETAIL\_SPACE           | Retail Space          |
| BUILTUP.INDUSTRIAL\_PROPERTY    | Industrial Property   |
| BUILTUP.MIXED\_USE\_DEVELOPMENT | Mixed-Use Development |
| BUILTUP.SELF\_STORAGE           | Self-Storage          |
| BUILTUP.SHOPPING\_MALL          | Shopping Mall         |

* **Ownership Type**

| Code                       | Property Type           |
| -------------------------- | ----------------------- |
| FEE\_SIMPLE\_OWNERSHIP     | Fee Simple Ownership    |
| LEASEHOLD\_OWNERSHIP       | Leasehold Ownership     |
| TENANCY\_IN\_COMMON\_(TIC) | Tenancy in Common (TIC) |

* **Boundary**

| Code   | Name                           |
| ------ | ------------------------------ |
| ALM001 | East End, West End             |
| ALM002 | Albany Hill, East Albany       |
| ALM003 | North Berkeley, South Berkeley |

* **Owner Type**

| Name                                       | Code                      |
| ------------------------------------------ | ------------------------- |
| Veterans                                   | VETERANS                  |
| Disabled Individuals                       | DISABLEINDIVIDUALS        |
| Minority Applicants                        | MINORITYAPPLICANTS        |
| LGBTQ+ Individuals                         | LGBTQ                     |
| Economically Disadvantaged                 | ECONOMICALLYDISADVANTAGED |
| Refugees and Asylum Seekers                | REFUGEEANDASYLUMSEEKERS   |
| Returning Citizens (formerly incarcerated) | RETURNINGCITIZENS         |
| Native American or Indigenous Peoples      | NATIVEAMRERICANS          |
| None of the above                          | NONE                      |

* **TL Billing Slab**

| Tenant ID  | License Type | Application Type | Structure Type  | Trade Type | Trade Category  | Trade Sub Category     | Trade Code                                 | Accessory Category | Type | UOM        | From UOM | To UOM    | Rate Trade Type | Rate Accessory Category |
| ---------- | ------------ | ---------------- | --------------- | ---------- | --------------- | ---------------------- | ------------------------------------------ | ------------------ | ---- | ---------- | -------- | --------- | --------------- | ----------------------- |
| ca.alameda | PERMANENT    | NEW              | IMMOVABLE.PUCCA | Goods      | Healthcare      | Dental Lab Services    | GOODS.HEALTHCARE.DENTALLABSERVICES         | ACC-1              | FLAT | GROSSUNITS | 0.00     | 10,000.00 | <p><br></p>     | 200.00                  |
| ca.alameda | PERMANENT    | NEW              | IMMOVABLE.PUCCA | Goods      | Retail          | Clothing Retail        | GOODS.RETAIL.CLOTHINGRETAIL                | ACC-2              | FLAT | GROSSUNITS | 0.00     | 10,000.00 | <p><br></p>     | 200.00                  |
| ca.alameda | PERMANENT    | NEW              | IMMOVABLE.PUCCA | Goods      | Food & Beverage | Packaged Food Products | GOODS.FOOD & BEVERAGE.PACKAGEDFOODPRODUCTS | null               | FLAT | GROSSUNITS | 0.00     | 10,000.00 | 500.00          | <p><br></p>             |
| ca.alameda | PERMANENT    | NEW              | IMMOVABLE.PUCCA | Goods      | Food & Beverage | Beverage Production    | GOODS.FOOD & BEVERAGE.BEVERAGEPRODUCTION   | null               | FLAT | GROSSUNITS | 0.00     | 10,000.00 | 500.00          | <p><br></p>             |

## Login Credentials

<table><thead><tr><th width="143">Role</th><th>URL</th></tr></thead><tbody><tr><td>Employee</td><td><a href="https://ips-demo.digit.org/digit-ui/employee/user/login">https://ips-demo.digit.org/digit-ui/employee/user/login</a></td></tr><tr><td>Citizen</td><td><a href="https://ips-demo.digit.org/digit-ui/citizen/select-language">https://ips-demo.digit.org/digit-ui/citizen/select-language</a></td></tr></tbody></table>

| Roles           | Username | Password  | City       | Phone      |
| --------------- | -------- | --------- | ---------- | ---------- |
| HRMS, Superuser | HRMSSU1  | Demo\@123 | Alameda    | 9999009902 |
| Superuser       | SUPERSU  | eGov\@123 | California | 9999009900 |

| Roles     | Username   | Password |
| --------- | ---------- | -------- |
| Citizen   | 6100000010 | 123456   |
| Architect | 6109981231 | 123456   |

<table><thead><tr><th width="209">Role</th><th width="159">Username</th><th>Password</th><th>ULB</th><th>ULB</th></tr></thead><tbody><tr><td><p>Common Role for Employees</p><p>Property Tax Counter Employee</p><p><br>TL Creator</p><p>TL Counter Employee</p><p><br>Counter Employee</p></td><td>CSR</td><td>Demo@123</td><td>Alameda</td><td>6000000001</td></tr><tr><td><p>Common Role for Employees</p><p>Property Tax Counter Employee</p><p><br>Business License Document verifier</p><p>Business License field inspector</p><p><br>BPA Services verifier</p><p>BPA Field Inspector</p><p>BPA NOC Verifier</p><p>FireNoc Approver</p><p>Airport Authority Approver</p></td><td>FieldEmployee</td><td>Demo@123</td><td>Alameda</td><td>6000000002</td></tr><tr><td><p>Common Role for Employees</p><p>Property Tax Counter Employee</p><p></p><p>TL Approver</p><p></p><p>Counter Employee</p><p>BPA Services Approver</p><p></p><p>BPAREG doc verifier</p><p>BPAREG Approver</p></td><td>OfficeEmployee</td><td>Demo@123</td><td>Alameda</td><td>6000000003</td></tr><tr><td><p>Common Role for Employees</p><p></p><p>State Administrator</p></td><td>Administrator</td><td>Demo@123</td><td>Alameda</td><td>6000000004</td></tr></tbody></table>

## Dependency Services

### 1. TL Service

This service is used to issue licenses to users after verification. The service is designed in such a way that it can be used to serve different types of licenses. Currently used to issue trade licenses, perform stakeholder registration and issue lockdown passes. The service is integrated with workflow where we can define the steps for application approval. Once the application is approved the license is generated.

#### Actions & Role Action Mapping&#x20;

Add Role-Action mapping for the APIs in MDMS. Following are the required entries.&#x20;

* MDMS Actions & Role Action Mapping for TL

<table><thead><tr><th width="276">displayName</th><th>Roles</th></tr></thead><tbody><tr><td>/tl-services/v1/_create</td><td>EMPLOYEE,CITIZEN,TL_APPROVER,TL_CEMP</td></tr><tr><td>/tl-services/v1/_update</td><td>EMPLOYEE,CITIZEN,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR,TL_APPROVER,TL_CEMP</td></tr><tr><td>/tl-services/v1/_search</td><td>EMPLOYEE,CITIZEN,TL_APPROVER,TL_CEMP,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR</td></tr><tr><td>/collection-services/payments/_create</td><td>TL_CEMP,SUPERUSER,EMPLOYEE</td></tr><tr><td>/inbox/v1/_search</td><td>TL_CEMP,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR,TL_APPROVER,AIRPORT_AUTHORITY_APPROVER</td></tr></tbody></table>

[**API Collection** ](https://api.postman.com/collections/29184917-8f3d4b0f-1e5d-4fd7-933b-6d3c6fb05916?access_key=PMAT-01JCG4D19SQQV7MZZDR78SGDXM)&#x20;

### 2. TL Calculator Service&#x20;

Trade License Calculator service is used to calculate the Trade license fees/renewal fees based on the defined billing slabs. This service enables the TL admins to create billing slabs with different combinations of license type, trade type, structure type and accessory type.

The service is designed in such a way that it can be used to serve different types of licenses.

#### Actions & Role Action Mapping&#x20;

Add Role-Action mapping for the API’s in MDMS. Following are the required entries.&#x20;

* MDMS Actions & Role Action Mapping for TL

<table><thead><tr><th width="315">displayName</th><th>Roles</th></tr></thead><tbody><tr><td>/tl-calculator/billingslab/_search</td><td>SUPERUSER,EMPLOYEE,TL_APPROVER,TL_CEMP,CITIZEN,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR</td></tr><tr><td>/tl-calculator/billingslab/_create</td><td>SUPERUSER</td></tr><tr><td>/tl-calculator/billingslab/_update</td><td>SUPERUSER</td></tr><tr><td>tl-calculator/v1/_getbill</td><td>EMPLOYEE,TL_APPROVER,TL_CEMP,CITIZEN</td></tr><tr><td>/tl-calculator/v1/_calculate</td><td>SUPERUSER</td></tr></tbody></table>

[**API Collection**](https://api.postman.com/collections/29184917-dfd8c8da-5815-4c46-a6bc-a10ddc187368?access_key=PMAT-01JCG4H8V6PWH717B33EB0EKKW) &#x20;

### 3. PT Service&#x20;

#### Actions & Role Action Mapping&#x20;

Add Role-Action mapping for the API’s in MDMS. Following are the required entries.&#x20;

* MDMS Actions & Role Action Mapping for PT

<table><thead><tr><th width="302">displayName</th><th>Roles</th></tr></thead><tbody><tr><td>/property-services/property/_search</td><td>CITIZEN,PT_CEMP,PT_DOC_VERIFIER,PT_FIELD_INSPECTOR,PT_APPROVER,TL_CEMP</td></tr><tr><td>/property-services/property/_create</td><td>CITIZEN,PT_CEMP,TL_CEMP</td></tr><tr><td>/property-services/property/_update</td><td>CITIZEN,PT_CEMP,PT_DOC_VERIFIER,PT_FIELD_INSPECTOR,PT_APPROVER,TL_CEMP</td></tr><tr><td>/pt-calculator-v2/propertytax/v2/_estimate</td><td>PT_CEMP,CITIZEN,TL_CEMP</td></tr><tr><td>/property-services/assessment/_create</td><td>SUPERUSER,PT_CEMP,CITIZEN,TL_CEMP,CITIZEN</td></tr><tr><td>/property-services/assessment/_search</td><td>TL_CEMP,SUPERUSER,PT_CEMP,CITIZEN</td></tr></tbody></table>

[**API Collection**](https://api.postman.com/collections/20639397-dee0745e-307a-40f9-90f2-34e861a1d46a?access_key=PMAT-01JCG7TXH4X5TECGNC21DBE4QH)

## **Referral Docs**

1. [**Local business license issuing module**](/local-governance/access/local-governance-stack/trade-license-tl)
2. [**Trade license master data templates**](/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates)
3. [**Trade license calculator**](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/trade-license-calculator)&#x20;

## **Bugs Found In TL**

<table><thead><tr><th width="137">Ticket reference</th><th width="203">Issue</th><th>RCA</th></tr></thead><tbody><tr><td>ISNE-378</td><td>TL: Create new application issue when user selects TL owner details from PT</td><td>In the code level, it is hardcoded that if ownershipcategory code includes (“SINGLEOWNER”or ”MULTIPLEOWNERS” or “INSTITUTIONAL”) then only it will form the owner object.<br><a href="https://github.com/egovernments/egov-mdms-data/commit/51a50852dd4a312aaea8c1b824864fd7bc7f0c47">https://github.com/egovernments/egov-mdms-data/commit/51a50852dd4a312aaea8c1b824864fd7bc7f0c47</a><br><a href="https://github.com/egovernments/egov-mdms-data/commit/dc8930811e28f0042b7694bf466870929cd5b483">https://github.com/egovernments/egov-mdms-data/commit/dc8930811e28f0042b7694bf466870929cd5b483</a></td></tr><tr><td>ISNE-366</td><td>TL: Accessory category options not displayed in UI</td><td><p>Accessory category needs to be added to TL billing slab</p><p>Property type and Ownership category are required to be having a dot separated value in mdms</p></td></tr><tr><td>ISNE-392</td><td>TL: Pop up message to be displayed when user clicks on payment button</td><td>Localization updated</td></tr><tr><td>ISNE-393</td><td><p>TL: Financial Year hard coded for TL renewal</p><p>Need to make it dynamic based on current TL validity period</p></td><td>Financial year was hard coded in the code,so fetched current financial year and from mdms data - validfrom and validto and Removed the hardcoded part of financial year.<br><a href="https://github.com/egovernments/DIGIT-Dev/commit/0971443040d2c192816165a93629f8df93489335">https://github.com/egovernments/DIGIT-Dev/commit/0971443040d2c192816165a93629f8df93489335</a> </td></tr><tr><td>ISNE-389</td><td>TL employee randomly gets navigated to citizen login screen</td><td>Removed working of isCreateEnabledEmployee variable because it was redirecting to another url without any reason.<br><a href="https://github.com/egovernments/DIGIT-Dev/commit/85bf283f163d0b19e8b981662fe5a8af09ab22b7">https://github.com/egovernments/DIGIT-Dev/commit/85bf283f163d0b19e8b981662fe5a8af09ab22b7</a> </td></tr></tbody></table>


# Business License Calculator

## Overview

Business License Calculator service is used to calculate the Trade license fees/renewal fees based on the defined billing slabs. This service enables the TL admins to create billing slabs with different combinations of license type, trade type, structure type and accessory type.\
The service is designed in such a way that it can be used to serve different types of licenses.

## Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

* *Java 8*
* Kafka server is up and running
* egov-persister service is running and has tl-calculation-persister & tl-billing-slab-persister config path added in it
* PSQL server is running and a database is created to store TL Application data
* Following services should be up and running:
  * egov-perister
  * egov-mdms
  * tl-services
  * billing-service

## Key Functionalities

* TL Admin an Employee of ULB with TL\_Admin role can create, update billing slab(s)
* ULB Employee with TL\_CREATOR and TL\_ADMIN can search billing slab(s)
* TL service internally calls tl-calculator to generate demand.

## Deployment Details

1. Deploy the latest version of tl-service and tl-calculator
2. Add tl-calculation-persister.yml & tl-billing-slab-persister.yml file in config folder in git and add that path in persister . *(The file path is to be added in environment yaml file in param called* persist-yml-path *)*

## Configuration Details

### MDMS Configuration

#### **MDMS for Penalty Calculation**

```
{
  "tenantId": "pb",
  "moduleName": "TradeLicense",
  "Penalty": [
    {
      "rate": 10,
      "minAmount": 0.0,
      "flatAmount": 0.0,
      "fromFY": "2018-19",
      "startingDay": "1/09/2018"
    },
    {
      "rate": 10,
      "minAmount": 0.0,
      "flatAmount": 0.0,
      "fromFY": "2015-16",
      "startingDay": "1/04/2016"

    }
  ]
}   
```

#### **MDMS file for Rebate Calculation**

```
{
  "tenantId": "pb",
  "moduleName": "TradeLicense",
  "Rebate": [
    {
      "rate": 10,
      "maxAmount": null,
      "flatAmount": 0.0,
      "fromFY": "2018-19",
      "endingDay": "31/03"

    },
    {
      "rate": 10,
      "maxAmount": null,
      "flatAmount": 0.0,
      "fromFY": "2019-20",
      "endingDay": "31/03"
    }
  ]  
}
```

### Actions & Role Action Mapping

#### **Actions**

```
[
  {
    "id": {{PLACEHOLDER1}},
    "name": "TL BillingSlab Create",
    "url": "/tl-calculator/billingslab/_create",
    "displayName": "TL BillingSlab Create",
    "orderNumber": 1,
    "parentModule": "",
    "enabled": false,
    "serviceCode": "",
    "code": "null",
    "path": ""
  },
  {
    "id": {{PLACEHOLDER2}},
    "name": "TL BillingSlab Update",
    "url": "/tl-calculator/billingslab/_update",
    "displayName": "TL BillingSlab Update",
    "orderNumber": 1,
    "parentModule": "",
    "enabled": false,
    "serviceCode": "",
    "code": "null",
    "path": ""
  },
  {
    "id": {{PLACEHOLDER3}},
    "name": "TL BillingSlab Search",
    "url": "/tl-calculator/billingslab/_search",
    "displayName": "TL BillingSlab Search",
    "orderNumber": 1,
    "parentModule": "",
    "enabled": false,
    "serviceCode": "",
    "code": "null",
    "path": ""
  },
  {
    "id": {{PLACEHOLDER4}},
    "name": "TL Calculation",
    "url": "/tl-calculator/v1/_calculate",
    "displayName": "TL Calculation",
    "orderNumber": 1,
    "parentModule": "",
    "enabled": false,
    "serviceCode": "",
    "code": "null",
    "path": ""
  }
]
```

#### **Role Action Mapping**

```
[
  {
    "rolecode": "TL_ADMIN",
    "actionid": "{{PLACEHOLDER1}}",
    "actioncode": "",
    "tenantId": "pb"
  },
  {
    "rolecode": "TL_ADMIN",
    "actionid": "{{PLACEHOLDER2}}",
    "actioncode": "",
    "tenantId": "pb"
  },
  {
    "rolecode": "TL_CREATOR",
    "actionid": "{{PLACEHOLDER3}}",
    "actioncode": "",
    "tenantId": "pb"
  },
  {
    "rolecode": "TL_CEMP",
    "actionid": "{{PLACEHOLDER3}}",
    "actioncode": "",
    "tenantId": "pb"
  },
  {
    "rolecode": "TL_CEMP",
    "actionid": "{{PLACEHOLDER4}}",
    "actioncode": "",
    "tenantId": "pb"
  }
]
```

## Integration Details

### Integration Scope

tl-calculator will be integrated with tl-services. tl-services internally invoke the tl-calculator service to calculate and generate demand for the charges.

### Integration Benefits

Tl calculator application is used to calculate the Trade license Fees based on the different billing slabs in the DB that's why the calculation and demand generation logic will be separated out from TL services.\
So in future, if calculation logic needs to modify then changes can be carried out for each implementation without modifying the TL services.

### Steps to Integration

1. TL application to call /tl-calculator/v1/\_calculate to calculate and generate the demand for the TL application
2. ULB Employee can create billing slab calling /tl-calculator/billingslab/\_create
3. ULB Employee can update billing slab calling /tl-calculator/billingslab/\_update
4. ULB Employee can search billing slab calling /tl-calculator/billingslab/\_search

### Interaction Diagram

TBD

## Reference Docs

#### Doc Links <a href="#doc-links" id="doc-links"></a>

|                        |                                                                                                                                                                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**              | **Link**                                                                                                                                                                                                                    |
| API Swagger Contract   | [![](https://editor.swagger.io/dist/favicon-32x32.png)Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/egovernments/egov-services/master/docs/rainmaker/trade-license/tl-calculator.yml#!/) |
| Trade License Document | [Trade License Service](https://digit-discuss.atlassian.net/l/c/WQ1uMqaa)                                                                                                                                                   |

#### API List <a href="#api-list" id="api-list"></a>

|                                    |                                                               |
| ---------------------------------- | ------------------------------------------------------------- |
| Title                              | **Link**                                                      |
| tl-calculator/billingslab/\_create | <https://www.getpostman.com/collections/a3d3bca66635df2395a3> |
| tl-calculator/billingslab/\_search | <https://www.getpostman.com/collections/a3d3bca66635df2395a3> |
| tl-calculator/billingslab/\_update | <https://www.getpostman.com/collections/a3d3bca66635df2395a3> |
| tl-calculator/v1/\_calculate       | <https://www.getpostman.com/collections/a3d3bca66635df2395a3> |

*(Note: All the API’s are in the same postman collection therefore the same link is added in each row)*


# Business License UI Configuration

UI configuration docs for the local business license issuing module


# Employee Inbox UI Details

The Inbox page contains 4 react components:-

## Application Links

Application Links is a separate component that holds links to other pages of possible navigation from the inbox. This component is common in both mobile and desktop views. Links are conditionally rendered according to the user roles.

![](/files/-MgiGZwlH22v7fSdBQM9)

## Search Application

The Search Application component is a form-based component, that controls the Table component and the search param for Inbox API, it uses FormComposer HOC to render fields.

Validation of these fields is achieved by using controlled component rules

![](/files/-MgiGZwoTfbuNgsB_1hQ)

Any number of search fields can be added but by convention, only mobile numbers and application numbers are provided.

## Filters

Filters contain input fields to filter the result of API, by sending search params to inbox API.

It contains 3 sections

1. Assigned to Me/ All - It is a radio component to send the assignedToMe param as *true* or *false.*
2. Locality - Filter result according to the selected locality by sending locality code in module search params in inbox API.
3. Status - Status filters are achieved by sending the id received from the inbox API response and mapping the name of businessService, status name and count

![](/files/-MgiGZwtYjYMWsXNkyvk)

## Table

The table is a react component which uses the React-Table plugin, used in multiple modules

![](/files/-MgiGZwxxGDgCp-jGT8d)

However, in Mobile view are using cards to list all the applications without pagination support.

## APIs

On Inbox page {env}[/inbox/v1/\_search?\_=1627374959930](https://qa.digit.org/inbox/v1/_search?_=1627374959930) is the only API that is called.

API CURL -

```
curl 'https://qa.digit.org/inbox/v1/_search?_=1627374959930' \
  -H 'authority: qa.digit.org' \
  -H 'sec-ch-ua: " Not;A Brand";v="99", "Google Chrome";v="91", "Chromium";v="91"' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'dnt: 1' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'user-agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36' \
  -H 'content-type: application/json;charset=UTF-8' \
  -H 'origin: https://qa.digit.org' \
  -H 'sec-fetch-site: same-origin' \
  -H 'sec-fetch-mode: cors' \
  -H 'sec-fetch-dest: empty' \
  -H 'referer: https://qa.digit.org/digit-ui/employee/tl/inbox' \
  -H 'accept-language: en-US,en;q=0.9,hi;q=0.8' \
  --data-raw '{"inbox":{"tenantId":"pb.amritsar","processSearchCriteria":{"moduleName":"tl-services","businessService":["NewTL","DIRECTRENEWAL","EDITRENEWAL"]},"moduleSearchCriteria":{"sortBy":"applicationDate","sortOrder":"ASC"},"limit":10,"offset":0},"RequestInfo":{"apiId":"Rainmaker","authToken":"18158d2b-0a50-4a60-baa3-a83c157e7aad","userInfo":{"id":12032,"uuid":"4dc1010d-4b31-4b31-a596-cec2986ac04c","userName":"QATLA","name":"Sham","mobileNumber":"9999999934","emailId":null,"locale":null,"type":"EMPLOYEE","roles":[{"name":"TL Approver","code":"TL_APPROVER","tenantId":"pb.amritsar"}],"active":true,"tenantId":"pb.amritsar","permanentCity":null}}}' \
  --compressed
```


# Business License Renewal UI Flow

## **Renewal Flow**

This feature allows the user to renew any trade license applications, which either has been expired or had to be renewed for current financial year (Approved and Paid), it also had integration with the payment component, in order to complete the flow all together for renewal.

Renewal can be two types:

* DIRECT RENEWAL
* EDIT RENEWAL

### **Renewal List**

Once the user clicks on Renew Trade License button on the home page, it will redirect to the renewal list page which will display all the applications eligible for renewal corresponding to the mobile number on which the user has logged in. It will show the Trade name, License Number, Owner Name and status whether active or expired.

Once the user clicks on Renew Button, it redirects the user to the summary page just like in edit Trade license, with all the values pre-populated from the search API. The info card will be declared so that the user will understand how to proceed with either direct renewal or edit renewal.

![](/files/r81D3de4F8K9g8Y6jQ7n)

### **Direct Renewal**

If the user just wants to renew the same application without updating any data, it will cross-verify all the values in the summary page and then click on submit button directly at the end of the page, this will lead the application to the next status as pending for payment and user can go through payment flow from the acknowledgement screen also, by clicking on the Make Payment button.

![](/files/I4GAW0SbwBAiUR0y14ns)

### **Edit Renewal**

If the user before renewal needs to update the application, they can do so by clicking on the change button on the summary screen, this will tell that the flow has been changed from direct to edit renewal, and the user will need to follow the same apply flow in order to complete the editing part of it. the values from the application will be pre-populated in the respective screens, to get the details about the edit flow, one can refer to this link. [Send Back Flow - Edit](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/send-back-edit-ui-flow).

Once the user clicks on submit button it will change the current action of the application to pending for document verification as the data has been updated.

## **Technical Implementation Details**

Renewal Trade main index can be found in the below-given link:

<https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/Renewal/index.js>

in this, we are calling the trade license search API, In order to get all the applications, through which the sorting is happened to classify which applications are eligible for renewal for the current financial year.

the hook which has been used for the API is:

```
const { isLoading, isError, error, data } = Digit.Hooks.tl.useTradeLicenseSearch({ filters: filter1 }, {});
  if (isLoading) {
    return <Loader />;
  }
```

The data from here then are sorted into the application which doesn’t have any open renewal application for the current financial year or which has a status of approved or expired. the significant method to get the renewal list of applications is mentioned below:

```
applicationsList.filter((response)=>response.licenseNumber).map((ob)=>{
    if(applications[ob.licenseNumber]){
    if(applications[ob.licenseNumber].applicationDate<ob.applicationDate)
    applications[ob.licenseNumber]=ob
    }
    else
    applications[ob.licenseNumber]=ob;    
    })
```

From here the Trade License List Component has been called which displays the list of the renewal application.

<https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/Renewal/TradeLicenseList.js>

The main functionality of converting the License Object received from the API to the object structure for formdata for apply flow, following is done in a similar way as the edit trade, and the same method is being used to convert the response object, to know more details please refer to[ Send Back Flow - Edit](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/send-back-edit-ui-flow)

Once the user has completed the flow as required or clicked the submit button directly, the method `convertToEditTrade` is being called, which re-arranges the data for the request body for the updated API `/tl-services/v1/_update`.

If it is a direct renewal only one update API is being called which updates the financial year only.

but if it is an edit renewal, two updated API is called after the first API successful call the application status gets changed to Initiated but after the second API call it is changed to applied. with the next action pending for document verification.

the code for these can be found in the utils folder index please refer to the below link for the same:

<https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/index.js>

## **MDMS**

MDMS data which is being used here is the same as the Apply flow only, as the flow structure used for edit renew trade is the same as the Apply for Trade License. Please refer to the link for detailed MDMS information.

[Trade License - Apply Flow](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/tl-apply-flow-ui-details)

## **Localisation**

For Renew Trade also, the Localization keys are being added in the ‘*rainmaker-tl*’ locale module. Change, update or add any new localization key will be done in the same locale module only.


# Send Back - Edit UI Flow

## **Edit Trade License**

This feature allows the user to edit the application already created under their mobile number. After verifying employee can send the application back to the citizen with remarks on any changes that needed to be done, which can be edited by the user using this flow.

## **Edit Application**

On the Application details page, on the employee side, if the application is marked with “Send Back to Citizen”, the edit option will appear dynamically at the end of the application details page, which the user can navigate through my applications.

<div align="left"><img src="/files/-MgiG_uMGz9A8jvj4e8O" alt=""></div>

After this, On clicking the button, the user can edit the trade license details by going through the Create Flow again. First, it will land on the Summary page, where for each section “change” button is there. Clicking on the Change button, the user will be redirected to the particular content, the only exception here will be the values will be pre-populated from the License object received from Trade License Search API, on completing the flow, Update API will be called and License application will get successfully updated.

<div align="left"><img src="/files/-MgiG_uOzb87Q9Khg1t9" alt="Acknowledgement Screen"></div>

## **Technical Implementation Details**

Edit Trade License main index can be found in the link given below:

<https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/EditTrade/index.js>

Here the main code consists of the function which results in transforming the License object received in Search API to the object structure which is suitable for citizen Apply flow (owner details, units, accessories etc), as the user needs to go through Apply flow again with pre-populated details and update the value of any accordingly. it also consists of the routing for the pages in the Apply flow.

getTradeEditDetails() function is being used so that the License object which is received from the Trade Search API, is converted to the Apply flow relevant structure so that the values can be pre-populated for the user convenience, on completing the flow, the application is updated. The link for the same can be found below:

[<img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/index.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/EditTrade/index.js)

User can delete and add as many accessory or units as it needs but there should be at least one unit to complete the application, to add a new unit or accessory “Add” button is used which is located at the end of the page. A new array is formed with all the updated details or with the old unit/accessory, when the flow is completed, this new array is then compared with the old array of accessories and units, and a new resulting array object is formed for the request body, you can find the respective code in the following method : `gettradeupdateaccessories` & `gettradeupdateunits`. this can be found in the below link[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/index.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/index.js)

Similarly, for owners the method which is used to form the new request param array is `gettradeownerarray`

It is similar to Accessories and Units - the only difference is in UI. Users can’t select multiple owners and only add one owner, it needs to either add more than one owner or select a single owner in the ownership category and proceed. After the successful update, the application's next action will be “Pending for document verification” as there is an update in the data.

On completing the flow, the same object structure which was being used earlier in the flow gets changed into the request body structure for the update API: `/tl-services/v1/_update`, for this, the method which gets used is declared inside the Utils folder. Method name: `convertToResubmitTrade` and it can be found in the below link:

{% embed url="<https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/index.js>" %}

<div align="left"><figure><img src="/files/esBb1yJ9tPYnAGxUJNCw" alt=""><figcaption></figcaption></figure></div>

## **MDMS**

MDMS data that is being used here is the same as the Apply flow only, as the flow structure used for edit trade is the same as the Apply for Trade License. Please refer to the link for detailed MDMS information.

[Trade License - Apply Flow](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/tl-apply-flow-ui-details)

## **Localisation**

For Edit Trade also, the localisation keys are added to the ‘*rainmaker-tl*’ locale module. Change, update or add any new localization key is done in the same locale module only.


# TL Apply Flow UI Details

**Objective:** To provide the facility for the user to create a trade license application for the current year by citizen users or counter employees.

## Workflow Details

<div align="left"><img src="/files/-MgiGb7Y-WyJWxUrXhAb" alt="TL Home Card"></div>

#### **Apply for Trade License**

Users can apply for a trade license application by clicking on the Apply for Trade License button. Users can add all the information as per the questions asked across the workflow. The summary screen at the end of the flow displays all details for review. Users can click on the submit button after review. The application for a trade license is created for the current financial year.

**Apply Flow** - The trade license registration screen is displayed after login which helps users identify the documents required to apply for a trade license. A citizen info card at the bottom of the page displays any additional information about the maximum size of the file that can be uploaded.

<div align="left"><img src="/files/-MiLWA6N0JZIUpeMmtF1" alt="Information Screen"></div>

**Trade License Details/Assessment Flow -** This flow captures the trade-specific information required for registering the trade.&#x20;

Trade Name - The user provides the name of the trade. An info card is displayed at the bottom of the screen stating that the license will be issued for the current financial year. The financial year value is retrieved from the MDMS.

<div align="left"><img src="/files/VXBZpLXZLH9cVXRB3XnR" alt=""></div>

Structure Type - The users can select yes or no based on whether the trade has mobility or not. If yes, the next screen prompts you to enter the vehicle type. If no, the next screen moves to the building type page.

<div align="left"><img src="/files/-MiLWA6V-b75mMEgrcDt" alt=""></div>

Vehicle Type / Building Type - The options for vehicle and building type are fetched from the MDMS. The Building Type screen displays an information card about the pucca or kuccha options.

<div align="left"><img src="/files/-MiLWA6_mcMw8SbnOQW6" alt="Vehicle Type"></div>

<div align="left"><img src="/files/mdRBzWm3iHZeVPobANqf" alt="Building Type"></div>

Commencement Date - It defines the date on which the trade started or will start in the future.

<div align="left"><img src="/files/jaC6K7m5UxLIa1DzTEEW" alt=""></div>

Trade Units - Users must provide the trade category as either goods or services. Based on the selected option the Trade Type is loaded from the MDMS as a drop-down list. The trade sub-type options are loaded based on the selected trade type. The unit of measure and UOM value get pre-populated from the MDMS as per the options selected above.

Users must enter at least one unit to move forward. Clicking on Add More Unit option enables users to enter additional units. Clicking on the delete icon on the top right corner of the unit card removes the unit.

<div align="left"><img src="/files/xhckGEDtSmvzIgd8fq83" alt=""></div>

<div align="left"><img src="/files/-MgiGb7iXpZPco0XcFa4" alt=""></div>

Accessories - The Accessory page inquires if there are any accessories required for the business. Accessories may not be compulsory for all trades. If yes, it will move to the accessory details page. If not, it will skip it altogether and will load the address flow.

<div align="left"><img src="/files/-MiLWA6eKxf8OSjXolQS" alt=""></div>

Accessory details - The options for accessories are retrieved from the MDMS. The Unit of Measure or UOM is pre-populated and cannot be edited. The users can edit the UOM value and the accessory count. In some cases, these are pre-populated from the MDMS. Clicking on Add More Trade Accessory button allows users to add multiple accessories.

<div align="left"><img src="/files/oNIg2DYRak3wL0LXqAzj" alt=""></div>

#### TL Enhanced Flow

If the citizen selects Movable as the structure type in the previous screens, then the flow will jump to the owner details flow. Here the Same as Property Owner’s check box will not be visible.

If the citizen selects Immovable as the structure type then the user is allowed to add the property details. Once the property is added, the flow will redirect to the owner details flow where the Same as Property Owner check box is displayed. If the user checks it, the following details get auto-populated and the screen skips to the proof of Identity page.

![](/files/tUO3sR5KSmAwgc3KIQFd)

**Common PT integration with TL:** After entering the trade details, users have the option to either search and integrate the already created property or create new lightweight property data for the trade license. This step can be skipped and users can proceed with the normal address details flow.

Once a property is selected user can see the details of the property on the property details page. Refer to the [Common PT ](/local-governance/access/local-governance-stack/property-tax/property-tax-service/common-pt)document for more details.

![](/files/7mf84aM62h0urdaJcrBj)![](/files/FoyBMNWZigDnW3veXRRa)<br>

![](/files/78X73S45yuhNZeh3Yei0)![](/files/5Vk3zXKgGumMPUokQQbO)

**Address Details Flow -** In the next flow, users have to enter the trade address details. This flow is straightforward, without any conditional routing.

![](/files/-MiLWA6gwJJInE-C89OK)

<div align="left"><img src="/files/-MiLWA6jb4otrKuBSq8r" alt=""></div>

Users can pinpoint the location in the Geo-location map, according to which pin code and city, as well as locality, is auto-filled.

**Owner Details Flow -** Finally, the users need to enter the trade owner details. Ownership can be Single or Multiple Owners. According to which the details are filled.

In the case of single/multiple owners, the following screen is displayed. The remaining flows remain the same.

<div align="left"><img src="/files/jNhUzJoAtPU0o10o44VB" alt=""></div>

Users can add multiple owners by clicking on the add owner button - a similar functionality as in trade units and accessories. The Add Owner button is not visible in case the user selects a single owner on the previous page.

The user must provide the owner's primary address and upload three documents that include address proof, owner identity and owner photograph.

![](/files/1SLG8qY7d34P5EHtJl7C)

**Check Page and Acknowledgement Screen -** Users can cross-verify the data entered throughout the flow in the Check page. Clicking on the change option adjacent to the data fields allows users to make any changes or updates to the data. The user is redirected back to a corresponding information page and the entire flow is repeated once again to submit the application.&#x20;

The Applying of Trade License Create API is called. Create API snippet:`1create: "/tl-services/v1/_create"`

If the API response is successful, then the Acknowledgement Screen is displayed, otherwise Failed Acknowledgement Screen is displayed.

<div align="left"><img src="/files/OY8EusXzWqhuZAQNmxjI" alt=""></div>

<div align="left"><img src="/files/-MiLWA6pd_4On7837NDi" alt=""></div>

Clicking on the Download Acknowledgement Form button downloads the PDF copy of the acknowledgement.

<div align="left"><img src="/files/-MgiGb7sWEy2iGOrnzPG" alt=""></div>

## **Release 2.8 Enhancements & Changes**

On the Trade Units page, values for trade type and trade subtype have been loaded by the following MDMS call:

{% code lineNumbers="true" %}

```
const { isLoading, data: Data = {} } = Digit.Hooks.tl.useTradeLicenseMDMS(stateId, "TradeLicense", "TradeUnits", "[?(@.type=='TL')]");
```

{% endcode %}

The following validations have been added for the same :

When users select trade type and then subtype, it is compared with the available billing slab. The hook for this is given below. In case the billing slab is not there it will not allow users to move forward and an error message is displayed.

{% code lineNumbers="true" %}

```
const { data: billingSlabTradeTypeData, isLoading : isBillingSlabLoading } = Digit.Hooks.tl.useTradeLicenseBillingslab({ tenantId: tenantId, filters: {} }, {
    select: (data) => {
    return data?.billingSlab.filter((e) => e.tradeType && e.applicationType === "NEW" && e.licenseType === "PERMANENT" && e.uom);
    }});
```

{% endcode %}

![](/files/Wel3Cxg2Cx0oeDS2N6va)

Once the correct trade type and subtype are added and the correct billing slab is there, the UOM value validation is added. This checks the value in the given range, mentioned in the billing slab object and displays an error if the value is outside of the range.

![](/files/knOWyRIi7zWcNMzxjVJC)

## **Technical Implementation Details**

All screens are developed using the new-UI structure followed previously in FSM, PGR and PT, except for multi-component.

The link for the Apply Trade License Main Index is given here and it helps understand the starting point of the flow: <https://github.com/egovernments/DIGIT-Dev/blob/master/frontend/micro-ui/web/micro-ui-internals/packages/modules/tl/src/pages/citizen/Create/index.js>

The TL (Trade License) module is segregated into a specified structure. The screen configuration is inside the PageComponent folder, and the configuration for routing of the pages are mentioned under the config folder which is common for both citizen users and employees. Below is the snippet for folder structure and routing configuration.

<div align="left"><img src="/files/-MgiGb7th9VIP2DH6as1" alt=""></div>

```
export const newConfig = [
  {
    head: "",
    body: [
      {
        type: "component",
        component: "TLInfoLabel",
        key: "tradedetils1",
        withoutLabel: true,
        hideInCitizen: true,
      }
    ]
  },
```

The pages folder is where the high-level configuration for controlling the whole flow is mentioned, for citizens and employees. Citizen flows include Create, Edit Trade, Renewal, Applications and Search Trade. The index or the starting point of the entire flow is available in this folder.

In the Accessory-details page, the Billing slab search API `"/tl-calculator/billingslab/_search"` is called. This returns the array list of all the accessories for which the billing slab has been configured. If the response returns an empty array then the options are curated from the MDMS API mentioned in the MDMS data section.

After completing the flow the user can download the acknowledgement PDF form of the License created.  PDF generation config link: <https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/getTLAcknowledgementData.js>

The Utils folder basically contains all the methods used throughout the TL module. Additional common methods can be imported and added to this folder.&#x20;

For creating an application the Create API from Trade License is called using the React hooks. This is declared in the hooks/elements/TL as TLService.

## **MDMS Data**

There are multiple pages within the workflows where data is imported from the MDMS. The table below lists the pages .js files for distinct page components.

| PageComponent            | MDMS Detail                                                    | Module Details Name | Master-Detail Name    |
| ------------------------ | -------------------------------------------------------------- | ------------------- | --------------------- |
| TradeLicense             | List of documents required for registration                    | `TradeLicense`      | `Documents`           |
| SelectTradeName          | Current Financial Year                                         | `egf-master`        | `FinancialYear`       |
| SelectVehicleType        | Type of mobility trade                                         | `common-masters`    | `StructureType`       |
| SelectBuildingType       | Type of Steady Trade                                           | `common-masters`    | `StructureType`       |
| SelectTradeUnits         | List of trade category and its corresponding type and sub-type | `TradeLicense`      | `TradeType`           |
| SelectAccessoriesDetails | Lit of Accessory and its Unit of measure and UOM value         | `TradeLicense`      | `AccessoriesCategory` |
| TLSelectAddress          | List of cities and its corresponding localities                | `TradeLicense`      | `tenants`             |
| SelectOwnerShipDetails   | categories imported are single and multiple owner.             | `common-masters`    | `OwnerShipCategory`   |
| SelectOwnerDetails       | List of Gender options.                                        | `common-masters`    | `GenderType`          |

React Hooks are used to call MDMS data that is shared across the modules. Below is the code snippet for the MDMS call.

```
const { isLoading, data: Documentsob = {} } = Digit.Hooks.tl.useTradeLicenseMDMS(stateId, "TradeLicense", "TLDocuments");
```

## **Localisation**

Localisation keys are added to the ‘*rainmaker-tl*’ locale module. In future, if any new labels are implemented in the Trade License (Citizen) it is pushed to the locale DB in the *rainmaker-tl* locale module. Below is an example of a few locale labels.

<div align="left"><img src="/files/-MgiGb7w-ZItsmIXOQ_2" alt=""></div>

## **API Role Action Mapping**

| API                                   | Action ID | Roles     |
| ------------------------------------- | --------- | --------- |
| `/egov-mdms-service/v1/_search`       | `954`     | `CITIZEN` |
| `/tl-services/v1/_create`             | `1685`    | `CITIZEN` |
| `/filestore/v1/files/url`             | `1528`    | `CITIZEN` |
| `/billing-service/bill/v2/_fetchbill` | `1862`    | `CITIZEN` |
| `/tl-calculator/billingslab/_search`  | `1684`    | `CITIZEN` |
| `/tl-services/v1/_update`             | `1686`    | `CITIZEN` |
| `/localization/messages/v1/_search`   | `1531`    | `CITIZEN` |


# My Applications UI Flow

## **Overview**

Users can review the list of applications and their status registered under their mobile numbers in the My Applications tab. Each Application for the initial view displays the Application No, Service Category, Owner Name (Multiple with a comma), status, SLA, and Trade Name with the View Details option. If the status is pending for payment the View Details & Pay button is available that enables the users to look up more details about the application.

<div align="left"><img src="/files/-MiLWA6tXEPgOJGka4tL" alt=""></div>

Once the user clicks on the View Details or View Details & Pay button, the Application Details Page is displayed with all the necessary information about the application.

<div align="left"><img src="/files/-MgiGaYxd9fgl200A-Hz" alt=""></div>

The user can download the Application Acknowledgement Form (status - pending for payment ) or TL Certificate or the payment receipt using the Download Link button available at the top right corner of the page.

<div align="left"><img src="/files/-MgiGaZ00v344OqGPflm" alt=""></div>

<div align="left"><img src="/files/-MgiGaZ33UT-YPgOh_ho" alt=""></div>

If the status is Pending for Payment for the application or Action required by a citizen (discussed elaborately here), a button will be visible to pay or edit at the end of the page respectively. On clicking on the Make Payment button it will redirect to the common pay screen through which the user can make the payment.

<div align="left"><img src="/files/-MgiGaZ8JJ7R-_H7ArGJ" alt=""></div>

**Timeline Component -** timeline component is present at the end of the application details which tells about the current status and history of the application being initiated, Applied, Pending for Document Verification, Pending for Field Inspection, Pending approval, Pending payment, Approved etc.

<div align="left"><img src="/files/-MgiGaZBcPPjpNLNr5i4" alt=""></div>

## **Technical Implementation Details**

The link for the Applications and Application Details main code is given below, it can be used to understand the working of the code, Below is the folder link.

[<img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/packages/modules/tl/src/pages/citizen/Applications at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/tree/main/packages/modules/tl/src/pages/citizen/Applications)

The template for My Application List is present under <https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/Applications/Application.js> and Application Details page is present inside - <https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/citizen/Applications/ApplicationDetails.js> .

All the Application lists are retrieved by calling the search API "`/tl-services/v1/_search`". If the view is set as “bills”, all the application is loaded using the hook `useFetchBill` which calls the `/billing-service/bill/v2/_fetchbill` API. SLA value in the Application List Screen is calculated from the data received from workflow API : `/egov-workflow-v2/egov-wf/process/_search`

Following is the hook used for the trade search API.

```
const { isLoading, isError, data, error, ...rest } = view === "bills" ? Digit.Hooks.tl.useFetchBill(
    {
      params: { businessService: "TL", tenantId, mobileNumber },
      config: { enabled: view === "bills" }
    }
  ) : Digit.Hooks.tl.useTLSearchApplication({}, {
    enabled: view !== "bills"
  });
```

To get the Application details in key-value format, in order to make it more compatible, the following hook is being used, which is a common service to be used across modules.

```
 const { isLoading, isError, error, data: application, error: errorApplication } = Digit.Hooks.tl.useTLApplicationDetails({
    tenantId: tenantId,
    applicationNumber: id,
  });
```

## **MDMS**

No MDMS data is being used here, all the data is being loaded from Search API/Fetch Bill API.

## **Localization**

For My Applications also the localization keys are added in the ‘*rainmaker-tl*’ locale module same as other parts of the TL module. Change, update or add any new localization key is done in the same locale module only.


# Employee Search Application Search License UI Flow

Search Application and Search License pages are used for searching any application/ license that may or may not be relevant to the workflow action of the logged-in users.

Search Application has 2 components.

## Search Fields

A search field component is a form which takes inputs and passes them into tl-search API params. It utilizes SearchForm and SearchField components to create and arrange the form.

![](/files/-MgiG_sVWI6r6v4qsP2o)

## Result Table

Result Table uses the Table react component and the result from API is adapted to the table config using a custom hook inside the common parent wrapper and passing the response to individual components.

![](/files/-MgiG_sYgEHzzEJfwOMU)

Search License has a fixed param where the status of the application is *“APPROVED”*, other than differences in table config

## APIs

The API end point for searching trade licenses is `{env}/tl-services/v1/_search`

API CURL -

```
curl 'https://qa.digit.org/tl-services/v1/_search?tenantId=pb.amritsar&fromDate=1625077800000&toDate=1627410599000&limit=10&sortBy=commencementDate&sortOrder=DESC&status=APPROVED&_=1627375567840' \
  -H 'authority: qa.digit.org' \
  -H 'sec-ch-ua: " Not;A Brand";v="99", "Google Chrome";v="91", "Chromium";v="91"' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'dnt: 1' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'user-agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36' \
  -H 'content-type: application/json;charset=UTF-8' \
  -H 'origin: https://qa.digit.org' \
  -H 'sec-fetch-site: same-origin' \
  -H 'sec-fetch-mode: cors' \
  -H 'sec-fetch-dest: empty' \
  -H 'referer: https://qa.digit.org/digit-ui/employee/tl/search/license' \
  -H 'accept-language: en-US,en;q=0.9,hi;q=0.8' \
  --data-raw '{"RequestInfo":{"apiId":"Rainmaker","authToken":"18158d2b-0a50-4a60-baa3-a83c157e7aad"}}' \
  --compressed
```


# New Trade License UI Flow

## **Objective**

The trade license 'apply' is the major feature in TL Module. It allows Citizens or Counter Employees to create TL Applications for the current financial year.

Every application is a part of the workflow. Once the user login with `TL_CEMP` role, then the User will get the option for creating a New TL Application in the TL card as well as in the inbox.

<div align="left"><img src="/files/-MgiGXnsWiYNbbQVmjqK" alt=""></div>

<div align="left"><img src="/files/-MgiGXnuLpszGy5Py5MU" alt=""></div>

File path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLCard.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/components/TLCard.js) and[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/DesktopInbox.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/components/inbox/DesktopInbox.js)

Clicking on New Application navigates to the New Trade License Application screen.

Route:[ ![](https://cdn.jsdelivr.net/npm/@egovernments/digit-ui-css/img/browser-icon.png)mSeva](https://qa.digit.org/digit-ui/employee/tl/new-application)

![](/files/-MgiGXny5MzY2hV834K4)

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/index.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/employee/NewApplication/index.js)

## **Technical Implementation Details**

Initial MDMS call is being made on page load like old UI.

## **MDMS Data**

Structure Type and Sub Structure Type field data is fetched from[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/StructureType.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/common-masters/StructureType.json)

Trade Category, Trade Type, Trade Sub Type field data is fetched from[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/TradeType.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/TradeLicense/TradeType.json)

Mohalla Data -[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/boundary-data.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/amritsar/egov-location/boundary-data.json) (For Amritsar)

Accessories -[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/AccessoriesCategory.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/TradeLicense/AccessoriesCategory.json)

Type of Ownership and Type of Sub ownership -[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/OwnerShipCategory.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/common-masters/OwnerShipCategory.json)[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/OwnerType.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/common-masters/OwnerType.json)

documents:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">egov-mdms-data/documentObj.json at master · egovernments/egov-mdms-data](https://github.com/egovernments/egov-mdms-data/blob/master/data/pb/TradeLicense/documentObj.json)

**Data fetch, load and render**

* Clicking on Submit button, `tl-services/v1/_create` api is called and create the application, after getting success response, we are calling update API `tl-services/v1/_update`.
* On loading the page, `/tl-calculator/billingslab/_search` api is called for showing the licence type (File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLTradeDetailsEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLTradeDetailsEmployee.js) ) and accessories options (File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLAccessoriesEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLAccessoriesEmployee.js) ).

**Acknowledgement Screen**

![](/files/-MgiGXo3un3eO7g9EU7y)

After the success of creating and updating calls will route to the acknowledgement screen.

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/getTLAcknowledgementData.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/getTLAcknowledgementData.js)

## **Role Action Mapping**

<table><thead><tr><th width="102">S.No.</th><th>API</th><th>Roles</th><th>Action ID</th></tr></thead><tbody><tr><td>1</td><td><code>/egov-mdms-service/v1/_search</code></td><td><code>TL_CEMP</code></td><td><code>954</code></td></tr><tr><td>2</td><td><code>/tl-services/v1/_create</code></td><td><code>TL_CEMP</code></td><td><code>1685</code></td></tr><tr><td>3</td><td><code>/tl-services/v1/_update</code></td><td><code>TL_CEMP</code></td><td><code>1686</code></td></tr><tr><td>4</td><td><code>/tl-calculator/billingslab/_search</code></td><td><code>TL_CEMP</code></td><td><code>1684</code></td></tr></tbody></table>


# Application Details - Trade Details UI Flows

## **Objective**

Provide employee purpose workflow actions.

The same screen is used for both application details and trade details.

Based on the conditions, we are showing the details here

Example: If the application is not in an approved state and the business Service New TL, then we are showing application details otherwise we are showing trade details.

## **Application Details**

For workflow action details, please refer to the file below.

{% content-ref url="/pages/-MgiGQwa-aT3Ug\_BqSBj" %}
[TL Apply Flow UI Details](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/tl-apply-flow-ui-details)
{% endcontent-ref %}

![](/files/-MgiGbT7iKlY6K6mnVlZ)

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/ApplicationDetails.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/employee/ApplicationDetails.js)

## **Trade Details**

![](/files/-MgiGbTAr5AGwKpYTBi3)

### Timeline View

<div align="left"><img src="/files/-MgiGbTDjMljkuWrDod0" alt=""></div>

It is common for all modules, find the path here:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/ApplicationDetailsContent.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/templates/ApplicationDetails/components/ApplicationDetailsContent.js)

The workflow is the same as Old UI only, please refer to the documentation link below.

{% content-ref url="/pages/-MgiGQwa-aT3Ug\_BqSBj" %}
[TL Apply Flow UI Details](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/tl-apply-flow-ui-details)
{% endcontent-ref %}

## **Role Action Mapping**

| S.No. | API                                         | Roles                                                                 | Action ID |
| ----- | ------------------------------------------- | --------------------------------------------------------------------- | --------- |
| 1     | `egov-mdms-service/v1/_search`              | `CR_PT`                                                               | `954`     |
| 2     | `/tl-services/v1/_update`                   | `TL_APPROVER, TL_CEMP, EMPLOYEE, TL_DOC_VERIFIER, TL_FIELD_INSPECTOR` | `2029`    |
| 3     | `/egov-workflow-v2/egov-wf/process/_search` | `EMPLOYEE`                                                            | `1730`    |
| 4     | `/tl-services/v1/_search`                   | `EMPLOYEE`, `TL_APPROVER`, `TL_CEMP`                                  | `1687`    |
| 5     | `/egov-hrms/employees/_search`              | `TL_APPROVER, TL_CEMP, EMPLOYEE, TL_DOC_VERIFIER, TL_FIELD_INSPECTOR` | `1752`    |


# Renew Edit Application

All the fields in this flow are the same as the New TL Application. The difference here is that max fields are having pre-populated data (On Loading the page, search is made for that particular application).

Will get the Renew Trade License option, when the application is in an approved state and the same financial year application is not present in the workflow.

File path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/ApplicationDetails.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/employee/ApplicationDetails.js)

![](/files/-MgiGbAZqtrpBKNBXfHU)

When we click on the Renew Trade License application, it will route to Renew screen

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/ApplicationDetails.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/employee/ApplicationDetails.js)

![](/files/-MgiGbAasxzFd9AIYHJw)

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/index.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pages/employee/ReNewApplication/index.js)

**Direct Renewal:** There is no change in any fields and directly clicks on submitting an application, an update API call is made for the respective application with respective to Direct Renewal (`applicationType`: `RENEWAL`, `workflowCode`: `DIRECTRENEWAL,` )and it will go into direct renewal flow.

**Edit Renewal:** If there is any change in any fields and clicks on submitting an application, an update API call is made with respect to edit renewal (`applicationType`: `RENEWAL`,`workflowCode`: `EDITRENEWAL` )and update the application and it will go into the edit renewal flow.

**Units, Accessories, Owners and documents details in case of Edit/Renewal flow**

1. Employee can edit units in both cases, employee can add and delete multiple units, please find the file below reg all use cases:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLTradeUnitsEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLTradeUnitsEmployee.js)
2. Employee cannot edit accessories in both cases, the employee can not add and delete multiple units and all fields are in disable state, please find the file below reg all use cases:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLAccessoriesEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLAccessoriesEmployee.js)
3. Employee can edit in both cases, expect ownership details, ownership details field is in disable state in both cases. please find the file below reg all use cases:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLTradeUnitsEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLTradeUnitsEmployee.js)
4. Employee can edit the documents in both cases, please find the file below reg all use cases:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/TLDocumentsEmployee.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/pageComponents/TLDocumentsEmployee.js)

**Acknowledgement Screen**

After a successful update call, the user is routed to the acknowledgement screen.

File Path:[ <img src="https://github.com/fluidicon.png" alt="" data-size="line">digit-ui-internals/getTLAcknowledgementData.js at main · egovernments/digit-ui-internals](https://github.com/egovernments/digit-ui-internals/blob/main/packages/modules/tl/src/utils/getTLAcknowledgementData.js)

**EDIT Flow:** It is also the same as renewal flow only, but we are passing the action `action`: `RESUBMIT` on the update call with all the changes.

**Application/ Trade Details:** [Application Details/Trade Details](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/application-details-trade-details-ui-flows)

**TL Create New Application:**[ New Trade License Application](/local-governance/access/local-governance-stack/trade-license-tl/tl-service-configuration/business-license-ui-configuration/new-trade-license-ui-flow)

## **Role Action Mapping**

<table><thead><tr><th width="126">S.No.</th><th>API</th><th>Roles</th><th>Action ID</th></tr></thead><tbody><tr><td>1</td><td><code>/egov-mdms-service/v1/_search</code></td><td><code>TL_CEMP</code></td><td><code>954</code></td></tr><tr><td>2</td><td><code>/tl-services/v1/_create</code></td><td><code>TL_CEMP</code></td><td><code>1685</code></td></tr><tr><td>3</td><td><code>/tl-services/v1/_update</code></td><td><code>TL_CEMP</code></td><td><code>1686</code></td></tr><tr><td>4</td><td><code>/tl-calculator/billingslab/_search</code></td><td><code>TL_CEMP</code></td><td><code>1684</code></td></tr></tbody></table>


# Local Business License Issuing System Implementation Guide

## Section 1: Executive Summary

### Overview of the Product

The computerized and automatic Business License Issuing system offered by eGov facilitates citizens who seek to apply for a business license within any Urban Local Body with a transparent, speedy, hassle-free and user-friendly procedure. Trade License (TL) is one of the components of a smart city that ensures a check on all the trade practices and increases the ease of conducting business within the state. Keeping in mind the benefits associated with the product offered, the proposed system is about to be implemented in 500+ ULBs across the country in 15 states. (For details on product features refer to [Section 2](#overview-of-the-product))

### Implementation Methodology for TL

For the offered product, the implementation process can be divided into seven major distinctive stages. Each stage has predefined entry and exit criteria, roles & responsibilities to assure objective monitoring and decision-making for the overall success of the engagement. The whole implementation lifecycle is typical of 38-42 weeks for the State, keeping in mind the entry and exit criteria defined at the beginning and end of each stage are met on time recommended.

<div align="left"><img src="https://lh6.googleusercontent.com/gqJprz2QBk0EE3cVJuHdRlj-6kkRDt-v8uJmhUw0PtN5cnl6Ekf2zAqfok8_-8JNLH8u9xwBpY7yTA5e3NI495b7PCXY_BjYHM6l4ady_DBZTe6jLOocdMhMUqT-IhTwzievJeQ" alt="Exhibit 1: Phases of Implementation."></div>

**Stage Zero** is that of program setup and onboarding which is a pre-requisite for the initiative to kick-off and requires setup of the governance model, implementation Team and decision regarding other significant elements of the initiative like funding and procurement process.&#x20;

**Stage One** - requires scoping of the initiative and decisions on the priorities for implementation by the State Implementation Team.&#x20;

**Stage Two** - the State Team works on identifying and finding solutions to the significant gaps in the product offered with respect to the need of the State.&#x20;

**Stage Three** - involves the Configuration and customization of the product offered. This involves working on various aspects of State-specific needs and incorporating them into the product offered.&#x20;

**Stage Four** - is about doing a pilot launch in UAT and including all the necessary feedback on the product.&#x20;

**Stage Five** - the roll-out of the product is done at the State level (Go Live) from a couple of ULBs to pan-state coverage in batches.&#x20;

**Stage Six** - sustenance and ongoing improvements are worked upon while the product is already functioning in the State. (For details on the implementation plan refer to [Section 3](#section-3-trade-license-tl-implementation-methodology))

### Critical Success Factors For Implementation

Implementation of the Trade License (TL) module requires meticulous planning and close coordination between various stakeholders at the centre and State levels. The success of the initiative is dependent upon many factors like strong Program governance, availability of trained resources, financial planning, targeted Implementation Team onboarding, focus on last-mile capacity building and ensuring necessary support to the Urban centre. Achievement of all these factors will provide the most effective and efficient roll-out and adoption of the Trade License System in the State.

## Section 2: Product Overview

The purpose of this document is to give an overview of the Trade License System (TLS). The Trade License product provides a digital interface, allowing citizens to apply for the Trade License and subsequently make the payment online.

The Trade License product enables:

* Ease of doing business — Traders can apply for new licenses, renewals, amendments, and supplemental licenses
* Regulatory Tracking — Administrators can track and manage regulatory processes
* Shorter Timelines — It streamlines and automates the business licensing processes and help a business to be set up quickly
* Data-driven decision making — The application collates valuable information on the economic activity and employment opportunities in a ULB

The TL product features can be broadly classified as the following modules:

1. Registration, Login and Creation of User Profile
2. Applying for a Trade License
3. Trade License Issue
4. Modifications to a Trade License
5. Renewal of Trade License
6. Payments and Fee
7. Dashboards and Reports
8. General Features

[Click here](/local-governance/access/local-governance-stack/trade-license-tl/tl-module-functional-specifications) to view module capabilities and product functional specifications.

## Section 3: Trade License (TL) Implementation Methodology

This section provides an overview of the methodology for State-wide implementation of TL. The Implementation of TL is distributed across seven distinct stages. Each stage has predefined entry & exit criteria and roles & responsibilities. This is to ensure objective monitoring and decision-making for the overall success of the program. Details of each stage are defined in this section.

<div align="left"><img src="https://lh4.googleusercontent.com/pYYmHAIeOJLerU7cHb-uPszewRSebMjf6_nxB80Rb-TmNDqsDEAHce5nAQUve0Nizl87dDt42EfcqEZcZkyk0RUmA-MeX4Xc6x8w0-UzsRxbwLvyyK_kCy5OK0TAP5a0mRTTIM4" alt=""></div>

{% hint style="info" %}
**Note:** This document is specific for States that have more than 30 ULBs
{% endhint %}

TL implementation program is expected to be completed approximately between 38- 42 weeks with the resource deployment by the State and System Integrator (SI) Team (as defined below). However, it is critical that activities and exit criteria set for each stage are achieved to adhere to this timeline.

### Seven Stages of Implementation For Trade License

### Stage 0 - Program Setup/Onboarding

This is a set of initial critical activities undertaken on receiving a letter of Enrolment or MOU from the State. Successful completion of these activities assures that the program is started with crucial personnel, System Integrator (SI) Teams, and funds.

<table><thead><tr><th width="345">Stage 0 - Program Setup/ On-Boarding</th><th></th></tr></thead><tbody><tr><td>Duration</td><td>4-6 weeks</td></tr><tr><td>Entry Criteria</td><td>Acceptance Letter/MoU by State</td></tr><tr><td>Exit Criteria</td><td><ul><li>Finalise Trade License Program Vision</li><li>Finalise funding for the program</li><li>Define State-specific procurement process</li><li>Trade License Cell appointment (*). Consisting of:</li><li>Domain expert</li><li>Nodal officer (EO/ Commissioner/ Senior Official)</li><li>Program Head</li><li>System Integrator (SI) Team sign-up/onboarding</li></ul></td></tr></tbody></table>

\*Details of TL cells are mentioned in [section 4](#section-4-roles-and-responsibilities-tl-cell-egov-team-and-system-integrator-si-team) of this handbook

#### System Integrator (SI) Sign-up:

* System Integrator and state will agree on program scope, program timelines, and budgeting & resourcing.

### Stage 1 - Program Kick-Off

This stage envisages the in-person interaction of crucial State officials and implementation System Integrator (SI) Teams to kick-start the program. This stage may require multiple interactions/meetings with different interest groups. The principal objective of these interactions is to identify scope and planning strategies for phasing/ rollout, create an active collaboration & Governance approach and agree on a high-level timeline for the engagement.

<table><thead><tr><th width="212">Duration</th><th>4-6 weeks</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>Program setup (Stage 0) is complete</li><li>SI Team signed-up</li></ul></td></tr><tr><td>Key Activities</td><td><ul><li>Project kick-off meeting and consultation from stakeholders</li><li>Identify &#x26; agree on high-level scope and exclusions</li><li>Identify pilot ULBs (using criteria such as business penetration, revenue generated from previous TL systems etc.)</li><li>Product Walkthroughs</li><li>Define Project Steering Committee structure and Project Governance process</li><li>Define phases of Rollout/ Deployment</li><li>Agreement on Deployment Priorities and high-level delivery timelines</li><li>Identify and study all TL process</li><li>Definition of TL as per the municipal governance of the State</li><li>State wise conceptualization of trade categories</li><li>Citizen services/channels around it</li><li>Integration with other Departmental processes (*)</li><li>Finalise Program Success Metrics for Rollout, Adoption and Governance adhering to the vision of the program</li><li>Internal Capacity Building, program logistics at State and ULBs, as per the current scenario</li><li>Collection of baseline data to measure end line target for the product (revenue generated, total properties in ULBs etc.)</li><li>Circulation of baseline data collection templates to the state/SI Team</li></ul></td></tr><tr><td>Exit Criteria</td><td><ul><li>Publish the program charter</li><li>Implementation plan agreement with priority features and broad timelines</li><li>Program Governance Model</li><li>Program Success Metrics</li><li>Capacity Building</li><li>TL Cell formation and appointment (#)</li><li>Data preparation/collection kick-off from Pilot ULBs</li><li>Cloud Infrastructure procured</li><li>Project Office Space allocated</li><li>Program Branding (name, logo, tagline etc.)</li></ul></td></tr></tbody></table>

\*Exploration is required to understand the Inter and Intra Departmental Jurisdictions of Local Governments with respect to Trade License.

\#Details of TL cell is mentioned in [section 4](#section-4-roles-and-responsibilities-tl-cell-egov-team-and-system-integrator-si-team) of this handbook

{% hint style="info" %}
**State Baseline Data:** A Baseline Template is provided to collect certain vital information like no. of transactions, revenue collected in the last FYs, collection mode, budget data, etc. This data must be collected pre-rollout
{% endhint %}

### Stage 2 - Solution Design

During the Solution design stage, key State officials and members, who are subject matter experts, are expected to share State acts and policies and help interpret the same for the System Integrator (SI) Team. This stage baselines the State-specific product features in the Product Configuration report.

<table><thead><tr><th width="228">Duration</th><th>4-6 weeks</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>Program Charter</li><li>TL cell appointment</li></ul></td></tr><tr><td>Key Activities</td><td><ul><li>Standardisation of all TL processes</li><li>Initiate policy change if needed, based on the Processes defined</li><li>Define criteria for success</li><li>Conduct Product familiarisation workshop</li><li>Initiate collection of master data from pilot ULBs</li><li>Finalise data migration/collection/sync-up approach as per requirement</li><li>Finalise data validation approach</li><li>Capacity Building for making state team aware about basic usage of tools like MS Office, mails etc.</li><li>Dashboard design finalisation for Program Tracking</li></ul></td></tr><tr><td>Exit Criteria</td><td><ul><li>State Sign Off and Publishing of the TL processes, data template/workflows</li><li>Finalisation of Roll-out plan (in different phases)</li><li>Product Configuration Report Sign Off</li><li>Solution agreement for required State- specific product customisations</li><li>Program tracking mechanism finalization and sign off by the state</li><li>Initial reporting structure</li><li>Dashboard KPIs</li><li>Sign-off on data approach (Data collection/migration/correction/ sync-up/validation)</li><li>Detailed project plan</li></ul></td></tr></tbody></table>

{% hint style="info" %}
Pilot ULBs Specific Product Data Configuration: Master data is required from the Product Perspective for going live. For e.g.: Boundary Data, List of Employees etc. A Master Data Template will be provided for the collection of this particular data type.
{% endhint %}

### Stage 3 - Configuration & Customisation

This stage consists of a series of developments in accordance with the detailed project plan to ensure the smooth functioning of the customised product. Master Data Collection & Environment Setup will be achieved in this phase. Further monitoring and maintenance strategies are put in place.

<table><thead><tr><th width="241">Duration</th><th>6-8 weeks</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>Product Configuration Report has been Signed Off by the state</li><li>Sign-off on data approach (Data collection/migration/correction/ sync-up/validation)</li><li>State Sign Off and Publishing of the TL processes, data template/workflows</li><li>Detailed Project Plan</li></ul></td></tr><tr><td>Key Activities</td><td><ul><li>Setting up development environments</li><li>Development/customisation of reports and dashboards</li><li>Development/Integration of portal</li><li>Third-Party Integrations (Payment gateway, Handheld/pos device)</li><li>Updation of user manuals and other key documents</li><li>Preparation &#x26; execution of Test Cases</li><li>Setup monitoring, support &#x26; maintenance processes, tools and dashboards</li><li>TL Legacy data collection from Pilot ULBs as per the data agreement signoff by the state</li><li>Capacity Building for making state team aware about basic usage of tools like MS Office, mails etc.</li><li>Identify ULB level nodal officers for day to day support</li><li>Migration and verification of Pilot ULB data as per the data agreement signoff by the state</li></ul></td></tr><tr><td>Exit Criteria</td><td><ul><li>Configured/Customized product that is ready for UAT</li><li>Set up of Monitoring, support &#x26; maintenance of Dashboards</li><li>finalization of Initial Reporting and Dashboard KPIs</li><li>Identification of participants for UAT session</li></ul></td></tr></tbody></table>

### Stage 4 - UAT & Go Live

During this stage, a demonstration of the product followed by a hands-on session is conducted for the ULB officials. Necessary training of ULB officials and resources required for UAT is conducted and identified respectively. The establishment of the State Support Team and required processes are initiated in this stage.

<table><thead><tr><th width="252">Duration</th><th>2-3 weeks</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>Configured/Customized product ready for UAT</li><li>Pilot ULB Officials associated with TL are available for UAT &#x26; Training</li></ul></td></tr><tr><td>Key Activities</td><td><ul><li>UAT Environment Setup</li><li>Issues/bug identification and resolution</li><li>Regression UAT and Sign off from Pilot ULBs/ State</li><li>Setting up the Production environment</li><li>Setting up Support Centre &#x26; processes (Help Desk)</li><li>Training (Users, trainer)</li><li>master trainers identified from ground for simultaneous training</li><li>Training the Support Resources</li><li>Marketing &#x26; promotion activities</li><li>Go Live &#x26; launch event</li><li><p>Setup of review and monitoring cadence/team</p><ul><li>Usage/review/Dashboard/Field Visits</li></ul></li></ul></td></tr><tr><td>Exit Criteria</td><td><ul><li>UAT Sign-off &#x26; Go Live for Pilot ULBs</li><li>Setup of review and monitoring cadence</li></ul></td></tr></tbody></table>

{% hint style="info" %}
**Note:** The Nodal Officer is responsible for identifying the ULB officials who are associated with the TL process on the ground and will be working with the technological Product in the respective ULBs
{% endhint %}

### Stage 5 – Rollout

On successful Go-Live in the Pilot ULBs, and further fine-tuning to stabilize the product, the solution will be rolled out to the rest of the ULBs in phases. Guidance and support from the State Team will be required to create the rollout plans and ensure the necessary infrastructure for training and deployment is available at each ULB.

{% hint style="info" %}
**Note:** The rollout phase needs to be detailed for iterative activities of onboarding ULBs in batches.
{% endhint %}

<table><thead><tr><th width="258">Duration</th><th>5-6 weeks</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>A pilot has been successful in the State</li><li>there are less than 3 open critical incidents (issues) with respect to product, implementation and data</li></ul></td></tr><tr><td>Key Activities</td><td><ul><li>ULB configurations phase wise as per the Project Plan</li><li>Verification and migration of ULB data phase wise as per the Data Agreement Sign Off provided by the State</li><li>Establishment of bug ticketing tool for resolving ground level issues by the state team</li><li>Training the Users at the district level</li><li><p>Pan State Roll Out - Phase wise</p><ul><li>Stabilise product</li></ul></li></ul></td></tr><tr><td>Exit Criteria</td><td><p>State-wide Rollout in batches:</p><ul><li>Adoption tracking &#x26; Review Cadence operational</li><li>Help Desk Effectiveness assured</li><li>Critical Bugs fixed</li><li>Program Success Metrics Tracking Kick-started</li></ul></td></tr></tbody></table>

{% hint style="info" %}
**Note:** Only once all the stages are complete in one batch of the rollout of around 30 ULBs, the next batch begin. There are multiple phases of rollout. The second batch begins after the first batch has successfully fulfilled all the criteria of the Rollout Phase. A typical timeline for the closure of rollout in each batch is 5-6 weeks (in a batch of 30 ULBs)
{% endhint %}

### Stage 6 – Sustenance and Ongoing Improvement

The final stage consists of strategies to ensure the sustenance of the product in the State. Systems are put in place to ensure the continuous tracking of data and provisions are made to improve the product if new data suggest.

<table><thead><tr><th width="214">Duration</th><th>Ongoing process</th></tr></thead><tbody><tr><td>Entry Criteria</td><td><ul><li>Rollout Phase 1(First set of ULBs where rollout will happen after Pilot)</li></ul></td></tr><tr><td>Key Ongoing Activities</td><td><ul><li>Adoption Review Meetings as per the vision defined for the program.</li><li>Meetings are chaired by the Program Head</li><li>Need to be conducted weekly</li><li><p>TL Cell Focuses on Using data for:</p><ul><li>tracking field issues and performance data to identify improvements</li><li>identify additional Integrations around TL to make processes more robust towards enhancing TL revenues (e.g. Upstream and downstream Processes)</li></ul></li><li>Plans of ongoing Sustenance in Place with respect to:</li><li>Funding</li><li>IT support</li><li>Process Effectiveness and Improvements</li></ul></td></tr></tbody></table>

## Section 4: Roles and Responsibilities - TL Cell, eGov Team & System Integrator (SI)Team

This section outlines the activities involved in each stage of the implementation along with the responsibility and accountability of critical stakeholders - State, eGov Team and System Integrator Team onboard.

TL Cell: TL Cell is the government-appointed body chaired by the Principal Secretary/Secretary, Urban Development Department with members from Urban Development Department etc.

Resource requirements for the TL cell required to be formed by the State

| Resource Name          | No. Of Resources |
| ---------------------- | ---------------- |
| Project Head           | 1                |
| Domain Expert          | 2                |
| District Nodal Officer | 1 per district   |
| MIS Expert             | 4                |

{% hint style="info" %}
Note:

* Designations mentioned above are as per designations already driving TLs implementation at the State level.
* The description of each designation is explained below.
* These are the preferred figures. In the case of Domain Expert, 2 people are subject to the availability
  {% endhint %}

{% hint style="info" %}
Description of resource persons:

* Project Head: Is the Head of the TL Cell who will drive the project from the State’s Side
* Domain Expert: A person who is well aware of the on-ground scenario, well versed with the act, GOs passed, Prevalent Business processes, Deviations from the acts, TL Rates/ slabs applicable
* Nodal officer (EO/Commissioner/ Senior Official): the project coordinator in each district to drive the project centrally. Monitor usage post Go Live- point of escalation for Implementation Team, Seasoned and worked in Multiple ULBs on various modules and has a good understanding of TL, Facilitates and Tracks data collection Post Go Live, Monitors and facilitates the adoption of the application. point of contact for eGov, SI and at the HQ level.
* MIS Expert: Day-to-day tracking of the data specific to ULBs, data entry, reporting and review to senior officials
  {% endhint %}

eGOv Team: eGov Team is the technical partner of the project which will provide all necessary support to the State concerning the implementation, Program Designing etc.

System Integrator (SI)Team: SI Team will be responsible for consulting, program management and the implementation of products in the ULBs in close collaboration with the TL cell, technical partner (eGov) and various other stakeholders.

{% hint style="info" %}
Guidelines to read the tables below:

Execute - One who owns the accountability to complete the activity

Consult - One who may initiate, guide and in the process, handhold the execution of the activity
{% endhint %}

| Stage 0 - Program Setup/ On-Boarding          |         |                  |
| --------------------------------------------- | ------- | ---------------- |
| Task/Activity                                 | eGov    | State Leadership |
| Appoint of TL Cell                            | Consult | Execute          |
| Finalise funding for the program              | Consult | Execute          |
| Define state -specific procurement process    | Consult | Execute          |
| System Integrator(SI) Team sign-up/onboarding | Consult | Execute          |
| Finalise Trade License Program Vision         | Consult | Execute          |

{% hint style="info" %}
**Note:** Stage 0 is where the TL cell and SI team is formed, hence there are only two entities playing a role which are that of eGov and the state leadership. Once the TL cell and SI team are finalised, their role begins in the following stages.
{% endhint %}

| Stage 1 - Program kick-off                                                                                                |         |         |         |
| ------------------------------------------------------------------------------------------------------------------------- | ------- | ------- | ------- |
| Task/Activity                                                                                                             | eGov    | TL Cell | SI Team |
| Identify & agree on scope and exclusions                                                                                  | Consult | Consult | Execute |
| Identify pilot ULBs                                                                                                       |         | Execute | Consult |
| Project Kickoff - Implementation Methodology Presentation                                                                 | Consult | Consult | Execute |
| Product Walkthroughs                                                                                                      | Consult |         | Execute |
| Define Project Steering Committee structure and Project Governance process                                                | Consult | Consult | Execute |
| Define phases of deployment/ rollout                                                                                      |         | Consult | Execute |
| Agreement on Deployment Priorities and high-level delivery timelines                                                      |         | Consult | Execute |
| Identify and study all TL process                                                                                         |         | Consult | Execute |
| Finalize Program Success Metrics for Adoption and Governance adhering to the vision of the program                        | Consult | Consult | Execute |
| Stage 1 - Program kick-off                                                                                                |         |         |         |
| Task/Activity                                                                                                             | eGov    | TL Cell | SI Team |
| Internal Capacity Building, program logistics at State and ULBs, as per the current scenario                              |         | Execute | Consult |
| Collection of baseline data to measure end line target for the product (Revenue generated, total properties in ULBs etc.) | Consult | Execute | Consult |
| Circulation of baseline data collection templates to the state/SI Team                                                    |         | Execute | Consult |

| Stage 2 - Solution Design                                                                           |         |         |         |
| --------------------------------------------------------------------------------------------------- | ------- | ------- | ------- |
| Task/Activity                                                                                       | eGov    | TL Cell | SI Team |
| Standardisation of all TL processes                                                                 |         | Consult | Execute |
| Define criteria for success                                                                         |         | Execute | Consult |
| Initiate policy change, if needed based on Processes defined                                        | Consult | Execute | Consult |
| Conduct Product familiarisation workshop                                                            |         | Consult | Execute |
| Initiate collection of master data from pilot ULBs                                                  |         | Consult | Execute |
| Finalise data migration/collection/sync-up approach                                                 |         | Consult | Execute |
| Finalise data validation approach                                                                   |         | Execute | Consult |
| Capacity Building for making state team aware about basic usage of tools like MS Office, mails etc. |         | Execute | Consult |
| Dashboard design finalisation for Program Tracking                                                  |         | Execute | Consult |

| Stage 3 – Configuration & Customization                                                             |      |         |         |
| --------------------------------------------------------------------------------------------------- | ---- | ------- | ------- |
| Task/Activity                                                                                       | eGov | TL Cell | SI Team |
| Setting up development environments                                                                 |      | Consult | Execute |
| Development/customisation of reports and dashboards                                                 |      | Consult | Execute |
| Development/Integration of portal                                                                   |      | Consult | Execute |
| Third-Party Integrations (Payment gateway, Handheld/pos device)                                     |      | Consult | Execute |
| Updation of user manuals and other key documents                                                    |      | Consult | Execute |
| Preparation & execution of Test Cases                                                               |      | Consult | Execute |
| Setup monitoring, support & maintenance processes, tools and dashboards                             |      | Consult | Execute |
| TL legacy data collection from Pilot ULBs (at least)                                                |      | Consult | Execute |
| Capacity Building for making state team aware about basic usage of tools like MS Office, mails etc. |      | Execute | Consult |
| Verification and Migration of Pilot ULB data                                                        |      | Consult | Execute |
| Identification of participants for UAT session                                                      |      | Execute | Consult |

| Stage 4 – UAT & Go Live                            |         |         |         |
| -------------------------------------------------- | ------- | ------- | ------- |
| Task/Activity                                      | eGov    | TL Cell | SI Team |
| UAT Environment Setup                              | Consult | Consult | Execute |
| Issues/bug identification and resolution           |         | Consult | Execute |
| Regression UAT and sign off from Pilot ULBs/ State |         | Execute | Consult |
| Setting up the Production environment              |         | Consult | Execute |
| Setting up Support Centre & processes (Help Desk)  |         | Execute | Consult |
| Training user                                      |         | Execute | Consult |
| Training Trainer                                   |         | Consult | Execute |
| Stage 4 – UAT & Go Live                            |         |         |         |
| Task/Activity                                      | eGov    | TL Cell | SI Team |
| Training the Support Resources                     |         | Consult | Execute |
| Marketing & promotion activities                   |         | Execute | Consult |
| Go Live & launch event                             | Consult | Execute | Execute |
| Setup of review and monitoring cadence/team        |         | Execute | Consult |

| Stage 5: Rollout                                                                                           |         |         |         |
| ---------------------------------------------------------------------------------------------------------- | ------- | ------- | ------- |
| Task/Activity                                                                                              | eGov    | TL Cell | SI Team |
| ULB configurations phase wise as per the Project Plan                                                      |         | Consult | Execute |
| Verification and Migration of ULB data phase wise as per the Data Agreement Sign Off provided by the State |         | Execute | Consult |
| Establishment of bug ticketing tool for resolving ground level issues by the state team                    |         | Consult | Execute |
| Training the Users at the district level                                                                   |         | Execute | Consult |
| Pan State Roll Out – Phase wise                                                                            | Consult | Execute | Execute |
| Stabilise product                                                                                          |         | Consult | Execute |

| Stage 6- Sustenance and Ongoing Improvement                                                                                                                                                                                                                                           |         |         |         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------- | ------- |
| Task/Activity                                                                                                                                                                                                                                                                         | eGov    | TL Cell | SI Team |
| Adoption Review Meetings as per the vision defined for the program                                                                                                                                                                                                                    | Consult | Execute | Consult |
| <p>TL Cell Focuses on Using data for:</p><ul><li>tracking field issues and performance data to identify improvements</li><li>identify additional Integrations around TL to make processes more robust towards enhancing TL revenues (e.g Upstream and downstream Processes)</li></ul> |         | Execute | Consult |
| <p>Plans of ongoing Sustenance in Place with respect to:</p><ul><li>Funding</li><li>IT support (infra, helpdesk, ongoing enhancements)</li><li>Process Effectiveness and Improvements</li></ul>                                                                                       | Consult | Execute | Consult |

## Section 5: Overall Program Assumptions

<table><thead><tr><th width="203">Areas</th><th>Assumptions</th></tr></thead><tbody><tr><td>Infrastructure</td><td><ul><li>The actual Infra will be provided based on the questionnaire inputs received from the state</li><li>The state will take care of providing necessary project infrastructure and office facilities during the program for all on-site project Team members, which will be confirmed during the initiation phase. This includes workspace, office equipment (e.g., telephone with STD, fax machine, photocopy machine, etc.), stationery, PC/workstation, project LAN and internet access, etc.</li><li>The state will provide the necessary administrative support staff to carry out day-to-day project administration tasks, e.g., meeting rooms, Videoconferencing, etc.</li><li>The state should provide a Project Office and at least one conference room with speakerphone throughout the Project Duration.</li></ul></td></tr><tr><td>Project Scope</td><td><ul><li>Any new requirements received from State during the implementation phase will be handled through a change management process</li></ul></td></tr><tr><td>State Team</td><td><ul><li>The state will nominate a reasonably sized multifunctional Team from various departments of the State to be responsible for the implementation. The state Team would be required for information, validation, and execution through the implementation cycle and the Team members should be reasonably empowered to take decisions. Any delay in the decision-making process and the non-availability of the State Team may have an impact on the schedule.</li><li>The participants from State are expected to have a thorough understanding of the State’s internal processes.</li><li>The state will engage internal and external stakeholders required for this engagement and ensure their availability whenever needed.</li></ul></td></tr><tr><td>Documentation</td><td><ul><li><p>The Tech Implementation Partner will ensure provision of the following:</p><ul><li>User education and training documentation delivery as per the default product documentation of the identified product versions.</li><li>Product manuals are expected to be shared with the State as part of the user manual.</li><li>All documentation in English and the language requirement of the state.</li></ul></li></ul></td></tr><tr><td>Training</td><td><ul><li>Training to the end-users will be driven by the state Team.</li><li>The state will be responsible for providing the necessary infrastructure required for the Training, which includes the following readiness.</li><li>Training Rooms (Parallel Training Sessions) with Projector, White Board, Markers, Internet Connection, sufficient seating capacity, Desktop/Laptop for each participant and availability of Network for Trainees to connect to the server.</li></ul></td></tr><tr><td>Implementation</td><td><ul><li>The scope of the implementation will be limited to the services mentioned in Section 2.</li><li>eGoc Team will have an identified SPOC for handling the first level of communication with the client unless discussed and agreed.</li><li>eGov Team will not be involved in defining the test cases or executing the test cases.</li><li>Necessary signoff would be provided by the state upon completion of the defined milestones.</li></ul></td></tr></tbody></table>

## Glossary

Vision: Defining the time frame to go live, the time frame to scale it pan state, the value proposition of the programme for the state and year-on-year financial targets and adoption targets

Project Plan: A detailed plan of Program schedule/timelines, implementation phases, team structure and ongoing support and maintenance is required.

System Integrator: The Entity/Company collates all the subsystems required for the project and integrates them to achieve the program objective

Program Charter: Outline of implementation plan agreement with priority applications and broad timelines, program governance model, program success metrics and capacity building.

Acceptance Letter/MOU: Formal Acceptance/Sign Off of the Client State with a clear mandate of the Program

Program Success Metrics: Defining the parameters (which are measurable) prior to the program, on which the success of the program is to be measured on the completion of the program

Project steering committee: The key body within the governance structure is responsible for the business issues associated with the project that are essential in ensuring the delivery of the project outputs and the attainment of project outcomes.

Project governance: Set of policies, regulations, functions, processes, procedures and responsibilities that define the establishment, management and control of projects, programmes and portfolios.

Scoping: List of activities measured against the time taken to complete them in accordance with the project goals

Baseline data: Set of information that serves as a foundation to compare other data acquired afterwards

Project Kick-off meeting: Meeting with the project team and the client of the project. This meeting would follow the definition of the base elements for the project and other project planning activities

Fitment Study: GAP Study of the Existing/Required Field Process Vs Product

Data migration: Existing Records of the functional activities need to be moved into the Database of the newly released Application

Data collection: Required data for the roll-out of the applications, which needs to be collected from the existing functional process

Data validation approach: This approach enables the sanctity of the Data with built-in validation by the Design

Data synchronization: The process of establishing consistency among data from a source to a target data storage and vice versa and the continuous harmonization of the data over time.

Pilot Implementation: Any new process is tested out as a pilot in one or two instances before pan implementation

Pilot ULB: The ULBs selected for the pilot implementation are called pilot ULBs.

Roll out: On successful clearance of the Pilot, the Process/Application/Services are implemented across all Offices/ULBs

Deployment: Deployment defines the complete package of Software components set up in a particular environment

Customization: Details of changes to be made in the Product to comply with the needed field process

Configuration: Defining existing content such as Options and Variables based on the requirements on the ground

Product walkthrough: Explaining to the users step-by-step through a set of actions that they need to take to achieve a specific outcome


# Property Tax System

Online automated management of property tax revenues and collections

## About Property Tax

The Property Tax System is a self-serve, web and mobile-based, easy-to-use and configurable application that addresses the objectives of municipal corporations and local government to automate all property tax operations, thus providing property tax assessment and payment services to citizens in real-time. The module offers a comprehensive system for calculating, generating, and managing property tax demands. It integrates with billing services, payment gateways, and finance modules to provide end-to-end property tax management functionality.

## Key Features

| <p></p><ul><li>Dynamic tax calculation based on configurable billing slabs</li><li>Support for multiple property types and usage categories</li><li>Penalty, rebate, and interest calculations</li><li>Advance payment and partial payment handling</li><li>Integration with finance systems for voucher creation</li><li>Demand generation and update mechanisms</li><li>SMS integration for notifications</li></ul> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## Section Overview

This section contains all docs and information required to understand the property tax module, its key features, functional scope, and configuration details. Click on the links below to learn more about deploying, configuring, customising, and using the PT module.

* [Functional Specifications](/local-governance/access/local-governance-stack/property-tax/pt-module-functional-specifications)
* [PT User Manual](/local-governance/access/local-governance-stack/property-tax/pt-user-manual)
* [Master Data Configuration Template](/local-governance/access/local-governance-stack/property-tax/pt-master-data-templates)
* [PT Service Configuration](/local-governance/access/local-governance-stack/property-tax/property-tax-service)
* [Implementation Handbook](/local-governance/access/local-governance-stack/property-tax/pt-implementation-guide)

{% hint style="warning" %}
**Navigation Tips**

* Click on the embedded links within the content to browse topic details
* Use the Contents links available on the right side of the screen to move to a specific heading
* Find the list of Related Docs links at the bottom of each page to browse through additional product details
  {% endhint %}


# Property Tax Architecture

### Overview

The DIGIT Property Tax module implements a microservices architecture with clearly defined core services, common services, and reusable components. The system follows event-driven patterns using Kafka for asynchronous processing and maintains data consistency through well-defined service interactions.

The Property Tax module consists of three main microservices:

1. property services - Legacy property management services
2. pt-services-v2 - Modern property management services
3. pt-calculator-v2 - Billing and tax calculation service

```
property-tax/
├── property-services/       # Legacy property management service
├── pt-services-v2/         # Modern property management service (V2)
└── pt-calculator-v2/       # Billing and tax calculation service (V2)
```

## 1. **property-services** - Legacy Property Management Service

The original property management service that handles comprehensive property data management, including:

* Property master data management
* Owner and institutional ownership tracking
* Property addresses with geolocation support
* Unit/floor-level details
* Property assessments for each financial year
* Document management (property documents, owner documents, assessment documents)
* Draft property submissions
* Property migration tracking
* Data encryption audit trails

**Key Features:**

* Complete CRUD operations for properties and assessments
* Support for both individual and institutional ownership
* Multi-unit/floor property support
* Comprehensive address management with GPS coordinates
* Financial year-based assessments
* Full audit trail through dedicated audit tables
* Property migration support from legacy systems
* Data encryption capabilities

## 2. **pt-services-v2** - Property Management Service V2

Modern redesigned service for property tax management with improved data structure:

* Streamlined property registration and management
* Enhanced owner information management
* Improved address and geolocation tracking
* Property detail and assessment management
* Unit-level property management
* Document management for properties and owners
* Institutional ownership support
* Draft property submissions
* Comprehensive audit trails

**Key Features:**

* Simplified and efficient data model
* JSONB support for flexible additional data
* Enhanced indexing for better performance
* Support for ad-hoc exemptions and penalties
* Improved multi-tenancy support
* Financial year-based property details
* Annual Rental Value (ARV) tracking
* Construction type and usage category management

#### 3. **pt-calculator-v2** - Tax Calculation Service V2

Specialised service handling all property tax calculations and billing:

* Billing slab configuration based on multiple property parameters
* Property tax calculation using configurable rate structures
* Mutation fee calculation for ownership transfers
* Assessment record management
* Dynamic rate determination based on:
  * Property type and subtype
  * Usage categories (Major/Minor/Sub-minor/Detail)
  * Ownership categories
  * Floor levels
  * Plot size ranges
  * Occupancy type
  * Area type
  * Market value (for mutation fees)

**Key Features:**

* Flexible multi-parameter billing slab system
* Support for unit rate and ARV percentage-based calculations
* Unbuilt land tax calculation
* Mutation fee calculation with fixed and percentage methods
* Market value-based fee determination
* Assessment of demand linking
* Tenant-specific rate configuration
* Multi-floored property support

## Technology Stack

* **Framework:** Spring Boot (Java 8+)
* **Database:** PostgreSQL 9.6+
* **Migration Tool:** Flyway
* **Data Formats:** JSON/JSONB for flexible data storage
* **Architecture:** Microservices-based
* **Multi-tenancy:** Supported across all services

## Module Package Structure

The Property Tax module follows DIGIT’s layered, event-driven architecture with a clear separation of responsibilities across packages. This makes the codebase easier to understand, navigate, and maintain.

Configuration is kept in **config**, business logic in **service**, utilities and constants in **util**, and validations in **validator**. Data access and external integrations are handled by the **repository**, with a **builder** for queries and a **rowmapper** for mapping database results. The **web** layer exposes APIs through **controllers** and defines request/response objects in **models**, while Kafka-based messaging is managed through **consumer** and **producer** packages.

```
config - Contains all the configuration properties related to the module
service - Consists of all services containing the business logic.
util - Contains utility functions and constants.
validator - Contains all validation code
repository - Fetch data from dependent micro services
repository/rowmapper - Rowmappers to convert db query results to object
repository/builder - Contains query builder for search
web/controllers - Controllers for the app.
web/models - POJO for the module.
consumer - Contains all the Kafka consumers,
producer - Contains kafka producer
```

The Property Tax Calculator module follows DIGIT’s event-driven microservices architecture. Its package structure separates messaging, data access, business logic, and configuration, making the codebase easier to understand and maintain.

Kafka interactions are handled through dedicated **consumers** and **producers**, database access is managed by **repository** and **query-builder** packages, domain data is defined in **models**, and all service and infrastructure settings are grouped under **config**.

```
property-tax-calculator/
├── consumer/           # Message queue consumers
├── producer/           # Message queue producers
├── repository/         # Data access layer
├── query-builder/      # Query construction utilities
├── models/            # Data models and entities
└── config/            # Configuration files
```

### Core Components

The core components encapsulate the key business workflows of the module. Listed below are the key components used by the module.

* **Calculator Service:** Implements property tax calculation rules
* **Demand Service:** Manages demand creation and updates
* **Billing Integration:** Interfaces with the billing service
* **Finance Integration:** Posts transactions to the finance system
* **Notification Service:** SMS and email notifications to citizens and officials at relevant stages


# Property Tax Database Schemas

## Overview

The database schema manages property tax information, including property details, ownership, assessments, and audit trails. The system supports multi-tenant architecture and tracks the complete property lifecycle from creation to assessment.

***

## Database Tables

### 1. eg\_pt\_property

**Purpose**: Core table storing property master data and metadata.

<table><thead><tr><th width="173.86328125">Column Name</th><th width="159.2421875">Data Type</th><th width="126.28125">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for the property</td></tr><tr><td>propertyid</td><td>VARCHAR(256)</td><td>UNIQUE (with tenantid, status)</td><td>Human-readable property ID</td></tr><tr><td>tenantid</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier for multi-tenancy</td></tr><tr><td>surveyid</td><td>VARCHAR(256)</td><td></td><td>Survey number of the property</td></tr><tr><td>accountid</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Account identifier for the property</td></tr><tr><td>oldpropertyid</td><td>VARCHAR(128)</td><td></td><td>Previous/legacy property ID for migration</td></tr><tr><td>status</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Property status (ACTIVE, INACTIVE, etc.)</td></tr><tr><td>acknowldgementnumber</td><td>VARCHAR(128)</td><td></td><td>Acknowledgement number for property registration</td></tr><tr><td>propertytype</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Type of property (BUILT_UP, VACANT, etc.)</td></tr><tr><td>ownershipcategory</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Ownership category (INDIVIDUAL, INSTITUTIONAL, etc.)</td></tr><tr><td>usagecategory</td><td>VARCHAR(256)</td><td></td><td>Usage category (RESIDENTIAL, COMMERCIAL, etc.)</td></tr><tr><td>creationreason</td><td>VARCHAR(256)</td><td></td><td>Reason for property creation (NEW, SUBDIVISION, etc.)</td></tr><tr><td>nooffloors</td><td>BIGINT</td><td></td><td>Number of floors in the property</td></tr><tr><td>landarea</td><td>NUMERIC(10,2)</td><td></td><td>Total land area in square units</td></tr><tr><td>superbuiltuparea</td><td>NUMERIC(10,2)</td><td></td><td>Total super built-up area</td></tr><tr><td>linkedproperties</td><td>VARCHAR(2048)</td><td></td><td>Comma-separated list of linked property IDs</td></tr><tr><td>source</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Source system (MUNICIPAL_RECORDS, etc.)</td></tr><tr><td>channel</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Channel of creation (WEB, MOBILE, COUNTER, etc.)</td></tr><tr><td>createdby</td><td>VARCHAR(128)</td><td></td><td>User who created the record</td></tr><tr><td>lastModifiedBy</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>createdTime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp (epoch milliseconds)</td></tr><tr><td>lastModifiedTime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr><tr><td>additionaldetails</td><td>JSONB</td><td></td><td>Additional flexible attributes in JSON format</td></tr></tbody></table>

**Indexes**: propertyid+tenantid+status, linkedproperties, accountId, tenantid, status, oldpropertyid, acknowldgementnumber, lastmodifiedtime+id

***

### 2. eg\_pt\_owner

**Purpose**: Stores property owner information linking users to properties.

<table><thead><tr><th width="146.7265625">Column Name</th><th width="156.6953125">Data Type</th><th width="175.796875">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>ownerinfouuid</td><td>VARCHAR(256)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for owner record</td></tr><tr><td>tenantid</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>propertyid</td><td>VARCHAR(256)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_property.id</td></tr><tr><td>userid</td><td>VARCHAR(128)</td><td>UNIQUE (with propertyid), NOT NULL</td><td>User ID from user service</td></tr><tr><td>status</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Owner status (ACTIVE, INACTIVE)</td></tr><tr><td>isprimaryowner</td><td>BOOLEAN</td><td></td><td>Flag indicating primary owner</td></tr><tr><td>ownertype</td><td>VARCHAR(256)</td><td></td><td>Type of owner (INDIVIDUAL, COMPANY, etc.)</td></tr><tr><td>ownershippercentage</td><td>VARCHAR(128)</td><td></td><td>Percentage of ownership</td></tr><tr><td>institutionid</td><td>VARCHAR(128)</td><td></td><td>Reference to institution if applicable</td></tr><tr><td>relationship</td><td>VARCHAR(128)</td><td></td><td>Relationship with primary owner</td></tr><tr><td>createdby</td><td>VARCHAR(128)</td><td></td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: tenantid, propertyid

***

### 3. eg\_pt\_institution

**Purpose**: Stores institutional owner details for properties owned by organisations.

<table><thead><tr><th width="134.46875">Column Name</th><th width="165.234375">Data Type</th><th width="191.3984375">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for institution</td></tr><tr><td>propertyid</td><td>VARCHAR(256)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_property.id</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>name</td><td>VARCHAR(1024)</td><td>NOT NULL</td><td>Name of the institution</td></tr><tr><td>nameofauthorizedperson</td><td>VARCHAR(1024)</td><td></td><td>Name of authorized person</td></tr><tr><td>type</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Type of institution (GOVERNMENT, PRIVATE, NGO, etc.)</td></tr><tr><td>designation</td><td>VARCHAR(128)</td><td></td><td>Designation of authorized person</td></tr><tr><td>createdby</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: tenantid, propertyid

***

### 4. eg\_pt\_address

**Purpose**: Stores property address and geolocation information.

<table><thead><tr><th width="140.2109375">Column Name</th><th width="152.66796875">Data Type</th><th width="193.57421875">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(256)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for address</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>propertyid</td><td>VARCHAR(256)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_property.id</td></tr><tr><td>doorno</td><td>VARCHAR(128)</td><td></td><td>Door/house number</td></tr><tr><td>plotno</td><td>VARCHAR(256)</td><td></td><td>Plot number</td></tr><tr><td>buildingName</td><td>VARCHAR(1024)</td><td></td><td>Building name</td></tr><tr><td>street</td><td>VARCHAR(1024)</td><td></td><td>Street name</td></tr><tr><td>landmark</td><td>VARCHAR(1024)</td><td></td><td>Nearby landmark</td></tr><tr><td>city</td><td>VARCHAR(512)</td><td></td><td>City name</td></tr><tr><td>pincode</td><td>VARCHAR(16)</td><td></td><td>Postal code</td></tr><tr><td>locality</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Locality/area code</td></tr><tr><td>district</td><td>VARCHAR(256)</td><td></td><td>District name</td></tr><tr><td>region</td><td>VARCHAR(256)</td><td></td><td>Region name</td></tr><tr><td>state</td><td>VARCHAR(256)</td><td></td><td>State name</td></tr><tr><td>country</td><td>VARCHAR(512)</td><td></td><td>Country name</td></tr><tr><td>latitude</td><td>NUMERIC(9,6)</td><td></td><td>Geographical latitude</td></tr><tr><td>longitude</td><td>NUMERIC(10,7)</td><td></td><td>Geographical longitude</td></tr><tr><td>createdby</td><td>VARCHAR(128)</td><td></td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr><tr><td>additionaldetails</td><td>JSONB</td><td></td><td>Additional flexible attributes</td></tr></tbody></table>

**Indexes**: tenantid, locality, propertyid

***

### 5. eg\_pt\_unit

**Purpose**: Stores individual unit/floor details within a property.

<table><thead><tr><th width="133.4140625">Column Name</th><th width="166.05078125">Data Type</th><th width="177.84765625">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for unit</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>propertyid</td><td>VARCHAR(128)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_property.id</td></tr><tr><td>floorNo</td><td>BIGINT</td><td></td><td>Floor number</td></tr><tr><td>unitType</td><td>VARCHAR(256)</td><td></td><td>Type of unit (ROOM, FLOOR, etc.)</td></tr><tr><td>usageCategory</td><td>VARCHAR(2048)</td><td>NOT NULL</td><td>Usage category (RESIDENTIAL, COMMERCIAL, etc.)</td></tr><tr><td>occupancyType</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Occupancy type (OWNER, TENANT, UNOCCUPIED)</td></tr><tr><td>occupancyDate</td><td>BIGINT</td><td></td><td>Date of occupancy</td></tr><tr><td>carpetArea</td><td>NUMERIC(10,2)</td><td></td><td>Carpet area in square units</td></tr><tr><td>builtUpArea</td><td>NUMERIC(10,2)</td><td></td><td>Built-up area</td></tr><tr><td>plinthArea</td><td>NUMERIC(10,2)</td><td></td><td>Plinth area</td></tr><tr><td>superBuiltUpArea</td><td>NUMERIC(10,2)</td><td></td><td>Super built-up area</td></tr><tr><td>arv</td><td>NUMERIC(10,2)</td><td></td><td>Annual Rental Value</td></tr><tr><td>constructionType</td><td>VARCHAR(1024)</td><td></td><td>Type of construction (RCC, BRICK, etc.)</td></tr><tr><td>constructionDate</td><td>BIGINT</td><td></td><td>Construction completion date</td></tr><tr><td>dimensions</td><td>JSON</td><td></td><td>Unit dimensions in JSON format</td></tr><tr><td>active</td><td>BOOLEAN</td><td></td><td>Flag indicating if unit is active</td></tr><tr><td>createdby</td><td>VARCHAR(128)</td><td></td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: tenantId, propertyid

***

### 6. eg\_pt\_document

**Purpose**: Stores document attachments related to properties.

<table><thead><tr><th width="126.74609375">Column Name</th><th width="153.6171875">Data Type</th><th width="185.79296875">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for document</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>entityid</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Entity ID (property/owner/unit) this document belongs to</td></tr><tr><td>documentType</td><td>VARCHAR(128)</td><td></td><td>Type of document (OWNERSHIP_PROOF, ID_PROOF, etc.)</td></tr><tr><td>fileStoreid</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>File store service reference ID</td></tr><tr><td>documentuid</td><td>VARCHAR(128)</td><td></td><td>Document unique identifier</td></tr><tr><td>status</td><td>VARCHAR(128)</td><td></td><td>Document status (ACTIVE, INACTIVE)</td></tr><tr><td>createdBy</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>User who created the record</td></tr><tr><td>lastModifiedBy</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>createdTime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastModifiedTime</td><td>BIGINT</td><td></td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: entityid, tenantid

***

#### 7. eg\_pt\_asmt\_assessment

**Purpose**: Stores property tax assessment information for each financial year.

<table><thead><tr><th width="147.0390625">Column Name</th><th width="147.40625">Data Type</th><th width="191.83984375">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(256)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for assessment</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>assessmentNumber</td><td>VARCHAR(64)</td><td>UNIQUE (with tenantId), NOT NULL</td><td>Human-readable assessment number</td></tr><tr><td>financialyear</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Financial year (e.g., 2023-24)</td></tr><tr><td>propertyId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Reference to property</td></tr><tr><td>status</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Assessment status (ACTIVE, CANCELLED, etc.)</td></tr><tr><td>source</td><td>VARCHAR(64)</td><td></td><td>Source system</td></tr><tr><td>channel</td><td>VARCHAR(256)</td><td></td><td>Channel of creation</td></tr><tr><td>assessmentDate</td><td>BIGINT</td><td>NOT NULL</td><td>Date of assessment</td></tr><tr><td>additionalDetails</td><td>JSONB</td><td></td><td>Additional flexible attributes</td></tr><tr><td>createdby</td><td>VARCHAR(64)</td><td></td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(64)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: assessmentNumber, propertyId, tenantid, financialyear, createdtime+id

***

### 8. eg\_pt\_asmt\_unitusage

**Purpose**: Stores unit-level usage details for tax assessments.

<table><thead><tr><th width="136.69140625">Column Name</th><th width="148.13671875">Data Type</th><th width="176.859375">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(256)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for unit usage</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>assessmentId</td><td>VARCHAR(256)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_asmt_assessment.id</td></tr><tr><td>unitId</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Reference to unit</td></tr><tr><td>usageCategory</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Usage category for assessment</td></tr><tr><td>occupancyType</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Occupancy type</td></tr><tr><td>occupancyDate</td><td>BIGINT</td><td></td><td>Date of occupancy</td></tr><tr><td>active</td><td>BOOLEAN</td><td></td><td>Flag indicating if record is active</td></tr><tr><td>createdby</td><td>VARCHAR(64)</td><td></td><td>User who created the record</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(64)</td><td></td><td>User who last modified the record</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: assessmentid

***

### 9. eg\_pt\_asmt\_document

**Purpose**: Stores document attachments related to assessments.

<table><thead><tr><th width="122.34375">Column Name</th><th width="143.03125">Data Type</th><th width="193.5">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for document</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>entityid</td><td>VARCHAR(128)</td><td>FOREIGN KEY, NOT NULL</td><td>Reference to eg_pt_asmt_unitusage.id</td></tr><tr><td>documentType</td><td>VARCHAR(128)</td><td></td><td>Type of document</td></tr><tr><td>fileStoreId</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>File store service reference ID</td></tr><tr><td>documentuid</td><td>VARCHAR(128)</td><td></td><td>Document unique identifier</td></tr><tr><td>status</td><td>VARCHAR(128)</td><td></td><td>Document status</td></tr><tr><td>createdBy</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>User who created the record</td></tr><tr><td>lastModifiedBy</td><td>VARCHAR(128)</td><td></td><td>User who last modified the record</td></tr><tr><td>createdTime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>lastModifiedTime</td><td>BIGINT</td><td>NOT NULL</td><td>Last modification timestamp</td></tr></tbody></table>

**Indexes**: entityid

***

### 10. eg\_pt\_property\_audit

**Purpose**: Audit trail table storing complete property snapshots for history tracking.

<table><thead><tr><th width="121.52734375">Column Name</th><th width="145.53125">Data Type</th><th width="154.6328125">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>audituuid</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Unique identifier for audit record</td></tr><tr><td>propertyid</td><td>VARCHAR(128)</td><td>NOT NULL</td><td>Reference to property</td></tr><tr><td>property</td><td>JSONB</td><td>NOT NULL</td><td>Complete property object snapshot in JSON</td></tr><tr><td>auditcreatedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Audit record creation timestamp</td></tr></tbody></table>

**Indexes**: propertyid

***

### 11. eg\_pt\_asmt\_assessment\_audit

**Purpose**: Audit trail for assessment records.

<table><thead><tr><th width="190.96484375">Column Name</th><th width="155.3671875">Data Type</th><th width="128.01171875">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Assessment ID</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>assessmentNumber</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Assessment number</td></tr><tr><td>financialyear</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Financial year</td></tr><tr><td>propertyId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Property reference</td></tr><tr><td>status</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Status</td></tr><tr><td>source</td><td>VARCHAR(64)</td><td></td><td>Source system</td></tr><tr><td>channel</td><td>VARCHAR(256)</td><td></td><td>Channel</td></tr><tr><td>assessmentDate</td><td>BIGINT</td><td>NOT NULL</td><td>Assessment date</td></tr><tr><td>additionalDetails</td><td>JSONB</td><td></td><td>Additional details</td></tr><tr><td>createdby</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Creator</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation time</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Last modifier</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Last modification time</td></tr><tr><td>auditcreatedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Audit record creation timestamp</td></tr></tbody></table>

***

### 12. eg\_pt\_asmt\_unitusage\_audit

**Purpose**: Audit trail for unit usage records.

<table><thead><tr><th width="154.1015625">Column Name</th><th width="162.40625">Data Type</th><th width="173.5546875">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Unit usage ID</td></tr><tr><td>tenantId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant/ULB identifier</td></tr><tr><td>assessmentId</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Assessment reference</td></tr><tr><td>unitId</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Unit reference</td></tr><tr><td>usageCategory</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Usage category</td></tr><tr><td>occupancyType</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Occupancy type</td></tr><tr><td>occupancyDate</td><td>BIGINT</td><td></td><td>Occupancy date</td></tr><tr><td>active</td><td>BOOLEAN</td><td></td><td>Active flag</td></tr><tr><td>createdby</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Creator</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation time</td></tr><tr><td>lastmodifiedby</td><td>VARCHAR(64)</td><td>NOT NULL</td><td>Last modifier</td></tr><tr><td>lastmodifiedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Last modification time</td></tr><tr><td>auditcreatedtime</td><td>BIGINT</td><td>NOT NULL</td><td>Audit record creation timestamp</td></tr></tbody></table>

***

### 13. eg\_pt\_property\_migration

**Purpose**: Tracks property data migration batches and progress.

<table><thead><tr><th width="137.56640625">Column Name</th><th width="143.58203125">Data Type</th><th width="226.12890625">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier for migration batch</td></tr><tr><td>batch</td><td>BIGINT</td><td>NOT NULL</td><td>Batch number</td></tr><tr><td>batchsize</td><td>BIGINT</td><td>NOT NULL</td><td>Size of the batch</td></tr><tr><td>tenantid</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant identifier</td></tr><tr><td>recordCount</td><td>BIGINT</td><td>NOT NULL</td><td>Number of records migrated</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr></tbody></table>

***

### 14. eg\_pt\_enc\_audit

**Purpose**: Audit trail for data encryption operations.

<table><thead><tr><th width="149.41796875">Column Name</th><th width="162.8671875">Data Type</th><th width="228.80078125">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier</td></tr><tr><td>batchoffset</td><td>BIGINT</td><td>NOT NULL</td><td>Batch offset for encryption</td></tr><tr><td>createdtime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr><tr><td>recordCount</td><td>BIGINT</td><td>NOT NULL</td><td>Number of records encrypted</td></tr><tr><td>tenantid</td><td>VARCHAR(256)</td><td>NOT NULL</td><td>Tenant identifier</td></tr><tr><td>message</td><td>VARCHAR(2048)</td><td>NOT NULL</td><td>Encryption message/log</td></tr><tr><td>encryptiontime</td><td>BIGINT</td><td>NOT NULL</td><td>Time taken for encryption</td></tr></tbody></table>

***

### 15. eg\_pt\_id\_enc\_audit

**Purpose**: Audit trail for property ID encryption operations.

<table><thead><tr><th width="158">Column Name</th><th width="171.31640625">Data Type</th><th width="177.0078125">Constraints</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>VARCHAR(128)</td><td>PRIMARY KEY, NOT NULL</td><td>Unique identifier</td></tr><tr><td>tenantid</td><td>VARCHAR(256)</td><td>UNIQUE (with propertyid, acknowldgementnumber), NOT NULL</td><td>Tenant identifier</td></tr><tr><td>propertyid</td><td>VARCHAR(256)</td><td></td><td>Property ID reference</td></tr><tr><td>acknowldgementnumber</td><td>VARCHAR(128)</td><td></td><td>Acknowledgement number</td></tr><tr><td>createdTime</td><td>BIGINT</td><td>NOT NULL</td><td>Creation timestamp</td></tr></tbody></table>

***

### Entity Relationship Diagram (ASCII)

```
     PROPERTY TAX SYSTEM - COMPLETE ER DIAGRAM               ║
╚═══════════════════════════════════════════════════════════════════════════════╝


┌─────────────────────────────────────────────────────────────────────────────┐
│                         CORE PROPERTY ENTITIES                               │
└─────────────────────────────────────────────────────────────────────────────┘

                    ┌───────────────────────────────────┐
                    │       eg_pt_property              │
                    ├───────────────────────────────────┤
                    │ PK  id                 VARCHAR(128)│
                    │     propertyid         VARCHAR(256)│
                    │     tenantid           VARCHAR(256)│
                    │     surveyid           VARCHAR(256)│
                    │     accountid          VARCHAR(128)│
                    │     oldpropertyid      VARCHAR(128)│
                    │     status             VARCHAR(128)│
                    │     acknowldgementnumber VARCHAR(128)│
                    │     propertytype       VARCHAR(256)│
                    │     ownershipcategory  VARCHAR(256)│
                    │     usagecategory      VARCHAR(256)│
                    │     creationreason     VARCHAR(256)│
                    │     nooffloors         BIGINT      │
                    │     landarea           NUMERIC(10,2)│
                    │     superbuiltuparea   NUMERIC(10,2)│
                    │     linkedproperties   VARCHAR(2048)│
                    │     source             VARCHAR(128)│
                    │     channel            VARCHAR(128)│
                    │     createdby          VARCHAR(128)│
                    │     lastModifiedBy     VARCHAR(128)│
                    │     createdTime        BIGINT      │
                    │     lastModifiedTime   BIGINT      │
                    │     additionaldetails  JSONB       │
                    └──────────┬─────────────────────────┘
                               │
             ┌─────────────────┼──────────────────┬──────────────────┐
             │                 │                  │                  │
             │                 │                  │                  │
             │                 │                  │                  │
   ┌─────────▼──────────┐  ┌──▼─────────────┐  ┌▼──────────────────┐  ┌────────▼────────────┐
   │   eg_pt_owner      │  │  eg_pt_unit    │  │  eg_pt_address    │  │ eg_pt_institution   │
   ├────────────────────┤  ├────────────────┤  ├───────────────────┤  ├─────────────────────┤
   │PK ownerinfouuid    │  │PK id           │  │PK id              │  │PK id                │
   │  VARCHAR(256)      │  │  VARCHAR(128)  │  │  VARCHAR(256)     │  │  VARCHAR(128)       │
   │FK propertyid       │  │FK propertyid   │  │FK propertyid      │  │FK propertyid        │
   │  VARCHAR(256)      │  │  VARCHAR(128)  │  │  VARCHAR(256)     │  │  VARCHAR(256)       │
   │  tenantid          │  │  tenantId      │  │  tenantId         │  │  tenantId           │
   │  VARCHAR(256)      │  │  VARCHAR(256)  │  │  VARCHAR(256)     │  │  VARCHAR(256)       │
   │  userid            │  │  floorNo       │  │  doorno           │  │  name               │
   │  VARCHAR(128)      │  │  BIGINT        │  │  VARCHAR(128)     │  │  VARCHAR(1024)      │
   │  status            │  │  unitType      │  │  plotno           │  │  nameofauthorized   │
   │  VARCHAR(128)      │  │  VARCHAR(256)  │  │  VARCHAR(256)     │  │   person            │
   │  isprimaryowner    │  │  usageCategory │  │  buildingName     │  │  VARCHAR(1024)      │
   │  BOOLEAN           │  │  VARCHAR(2048) │  │  VARCHAR(1024)    │  │  type               │
   │  ownertype         │  │  occupancyType │  │  street           │  │  VARCHAR(128)       │
   │  VARCHAR(256)      │  │  VARCHAR(256)  │  │  VARCHAR(1024)    │  │  designation        │
   │  ownershippercentage│ │  occupancyDate │  │  landmark         │  │  VARCHAR(128)       │
   │  VARCHAR(128)      │  │  BIGINT        │  │  VARCHAR(1024)    │  │  createdby          │
   │  institutionid     │  │  carpetArea    │  │  city             │  │  VARCHAR(128)       │
   │  VARCHAR(128)      │  │  NUMERIC(10,2) │  │  VARCHAR(512)     │  │  createdtime        │
   │  relationship      │  │  builtUpArea   │  │  pincode          │  │  BIGINT             │
   │  VARCHAR(128)      │  │  NUMERIC(10,2) │  │  VARCHAR(16)      │  │  lastmodifiedby     │
   │  createdby         │  │  plinthArea    │  │  locality         │  │  VARCHAR(128)       │
   │  VARCHAR(128)      │  │  NUMERIC(10,2) │  │  VARCHAR(128)     │  │  lastmodifiedtime   │
   │  createdtime       │  │  superBuiltUpArea│ │  district         │  │  BIGINT             │
   │  BIGINT            │  │  NUMERIC(10,2) │  │  VARCHAR(256)     │  └─────────────────────┘
   │  lastmodifiedby    │  │  arv           │  │  region           │
   │  VARCHAR(128)      │  │  NUMERIC(10,2) │  │  VARCHAR(256)     │
   │  lastmodifiedtime  │  │  constructionType│ │  state            │
   │  BIGINT            │  │  VARCHAR(1024) │  │  VARCHAR(256)     │
   └────────────────────┘  │  constructionDate│ │  country          │
                           │  BIGINT        │  │  VARCHAR(512)     │
                           │  dimensions    │  │  latitude         │
                           │  JSON          │  │  NUMERIC(9,6)     │
                           │  active        │  │  longitude        │
                           │  BOOLEAN       │  │  NUMERIC(10,7)    │
                           │  createdby     │  │  createdby        │
                           │  VARCHAR(128)  │  │  VARCHAR(128)     │
                           │  createdtime   │  │  createdtime      │
                           │  BIGINT        │  │  BIGINT           │
                           │  lastmodifiedby│  │  lastmodifiedby   │
                           │  VARCHAR(128)  │  │  VARCHAR(128)     │
                           │  lastmodifiedtime│ │  lastmodifiedtime │
                           │  BIGINT        │  │  BIGINT           │
                           └────────────────┘  │  additionaldetails│
                                               │  JSONB            │
                                               └───────────────────┘
```

```
 ┌────────────────────┐
                           │  eg_pt_document    │
                           ├────────────────────┤
                           │PK id               │
                           │  VARCHAR(128)      │
                           │  tenantId          │
                           │  VARCHAR(256)      │
                           │  entityid          │
                           │  VARCHAR(256)      │
                           │  documentType      │
                           │  VARCHAR(128)      │
                           │  fileStoreid       │
                           │  VARCHAR(128)      │
                           │  documentuid       │
                           │  VARCHAR(128)      │
                           │  status            │
                           │  VARCHAR(128)      │
                           │  createdBy         │
                           │  VARCHAR(128)      │
                           │  lastModifiedBy    │
                           │  VARCHAR(128)      │
                           │  createdTime       │
                           │  BIGINT            │
                           │  lastModifiedTime  │
                           │  BIGINT            │
                           └────────────────────┘
                           (Links to property/owner/unit via entityid)
```

```
 ASSESSMENT ENTITIES                                 │
└─────────────────────────────────────────────────────────────────────────────┘

                    ┌────────────────────────────────┐
                    │  eg_pt_asmt_assessment         │
                    ├────────────────────────────────┤
                    │PK id                VARCHAR(256)│
                    │  tenantId           VARCHAR(256)│
                    │  assessmentNumber   VARCHAR(64) │
                    │  financialyear      VARCHAR(256)│
                    │  propertyId         VARCHAR(256)│ (ref to eg_pt_property)
                    │  status             VARCHAR(64) │
                    │  source             VARCHAR(64) │
                    │  channel            VARCHAR(256)│
                    │  assessmentDate     BIGINT      │
                    │  additionalDetails  JSONB       │
                    │  createdby          VARCHAR(64) │
                    │  createdtime        BIGINT      │
                    │  lastmodifiedby     VARCHAR(64) │
                    │  lastmodifiedtime   BIGINT      │
                    └──────────────┬─────────────────┘
                                   │
                                   │ 1:N
                                   │
                    ┌──────────────▼─────────────────┐
                    │  eg_pt_asmt_unitusage          │
                    ├────────────────────────────────┤
                    │PK id               VARCHAR(256)│
                    │  tenantId          VARCHAR(256)│
                    │FK assessmentId     VARCHAR(256)│
                    │  unitId            VARCHAR(64) │
                    │  usageCategory     VARCHAR(256)│
                    │  occupancyType     VARCHAR(64) │
                    │  occupancyDate     BIGINT      │
                    │  active            BOOLEAN     │
                    │  createdby         VARCHAR(64) │
                    │  createdtime       BIGINT      │
                    │  lastmodifiedby    VARCHAR(64) │
                    │  lastmodifiedtime  BIGINT      │
                    └──────────────┬─────────────────┘
                                   │
                                   │ 1:N
                                   │
                    ┌──────────────▼─────────────────┐
                    │  eg_pt_asmt_document           │
                    ├────────────────────────────────┤
                    │PK id               VARCHAR(128)│
                    │  tenantId          VARCHAR(256)│
                    │FK entityid         VARCHAR(128)│ (ref to unitusage)
                    │  documentType      VARCHAR(128)│
                    │  fileStoreId       VARCHAR(128)│
                    │  documentuid       VARCHAR(128)│
                    │  status            VARCHAR(128)│
                    │  createdBy         VARCHAR(128)│
                    │  lastModifiedBy    VARCHAR(128)│
                    │  createdTime       BIGINT      │
                    │  lastModifiedTime  BIGINT      │
                    └────────────────────────────────┘
```

```
  AUDIT TABLES                                    │
└─────────────────────────────────────────────────────────────────────────────┘

  ┌───────────────────────────┐  ┌─────────────────────────────┐  ┌──────────────────────────┐
  │ eg_pt_property_audit      │  │ eg_pt_asmt_assessment_audit │  │ eg_pt_asmt_unitusage     │
  ├───────────────────────────┤  ├─────────────────────────────┤  │         _audit           │
  │ audituuid      VARCHAR(128)│  │ id              VARCHAR(256)│  ├──────────────────────────┤
  │ propertyid     VARCHAR(128)│  │ tenantId        VARCHAR(256)│  │ id          VARCHAR(256) │
  │ property       JSONB       │  │ assessmentNumber VARCHAR(64)│  │ tenantId    VARCHAR(256) │
  │ auditcreatedtime BIGINT    │  │ financialyear   VARCHAR(256)│  │ assessmentId VARCHAR(256)│
  └───────────────────────────┘  │ propertyId      VARCHAR(256)│  │ unitId      VARCHAR(64)  │
                                  │ status          VARCHAR(64) │  │ usageCategory VARCHAR(256)│
                                  │ source          VARCHAR(64) │  │ occupancyType VARCHAR(64)│
                                  │ channel         VARCHAR(256)│  │ occupancyDate BIGINT     │
                                  │ assessmentDate  BIGINT      │  │ active      BOOLEAN      │
                                  │ additionalDetails JSONB     │  │ createdby   VARCHAR(64)  │
                                  │ createdby       VARCHAR(64) │  │ createdtime BIGINT       │
                                  │ createdtime     BIGINT      │  │ lastmodifiedby VARCHAR(64)│
                                  │ lastmodifiedby  VARCHAR(64) │  │ lastmodifiedtime BIGINT  │
                                  │ lastmodifiedtime BIGINT     │  │ auditcreatedtime BIGINT  │
                                  │ auditcreatedtime BIGINT     │  └──────────────────────────┘
                                  └─────────────────────────────┘
```

```
 UTILITY TABLES                                    │
└─────────────────────────────────────────────────────────────────────────────┘

  ┌─────────────────────────┐  ┌──────────────────────────┐  ┌───────────────────────────┐
  │ eg_pt_property_migration│  │  eg_pt_enc_audit         │  │  eg_pt_id_enc_audit       │
  ├─────────────────────────┤  ├──────────────────────────┤  ├───────────────────────────┤
  │PK id         VARCHAR(128)│  │PK id         VARCHAR(128)│  │PK id         VARCHAR(128) │
  │  batch       BIGINT      │  │  batchoffset BIGINT      │  │  tenantid    VARCHAR(256) │
  │  batchsize   BIGINT      │  │  createdtime BIGINT      │  │  propertyid  VARCHAR(256) │
  │  tenantid    VARCHAR(256)│  │  recordCount BIGINT      │  │  acknowldgementnumber     │
  │  recordCount BIGINT      │  │  tenantid    VARCHAR(256)│  │              VARCHAR(128) │
  │  createdtime BIGINT      │  │  message     VARCHAR(2048)│ │  createdTime BIGINT       │
  └─────────────────────────┘  │  encryptiontime BIGINT   │  └───────────────────────────┘
                                └──────────────────────────┘
```

```
  RELATIONSHIP SUMMARY                                │
└─────────────────────────────────────────────────────────────────────────────┘

FOREIGN KEY RELATIONSHIPS:
  eg_pt_property (1) ──────< eg_pt_owner (N)
                     └─────< eg_pt_unit (N)
                     └─────< eg_pt_address (N)
                     └─────< eg_pt_institution (N)

  eg_pt_asmt_assessment (1) ──────< eg_pt_asmt_unitusage (N)
  eg_pt_asmt_unitusage (1) ───────< eg_pt_asmt_document (N)

REFERENCE RELATIONSHIPS (No FK):
  eg_pt_asmt_assessment.propertyId ────> eg_pt_property.id
  eg_pt_document.entityid ─────────────> property/owner/unit (varies)


LEGEND:
═══════════════════════════════════════════════════════════════════════════════
PK  = Primary Key
FK  = Foreign Key
──< = One-to-Many Relationship (Foreign Key)
───> = Reference Relationship (No FK Constraint)
(N) = Many side of relationship
(1) = One side of relationship
═══════════════════════════════════════════════════════════════════════════════
```

### Relationship Summary

#### Primary Relationships

1. **Property → Owners** (1:N)
   * One property can have multiple owners
   * FK: eg\_pt\_owner.propertyid → eg\_pt\_property.id
2. **Property → Units** (1:N)
   * One property can have multiple units/floors
   * FK: eg\_pt\_unit.propertyid → eg\_pt\_property.id
3. **Property → Address** (1:N)
   * One property can have multiple addresses
   * FK: eg\_pt\_address.propertyid → eg\_pt\_property.id
4. **Property → Institution** (1:N)
   * One property can be linked to multiple institutions
   * FK: eg\_pt\_institution.propertyid → eg\_pt\_property.id
5. **Assessment → Unit Usage** (1:N)
   * One assessment can have multiple unit usage entries
   * FK: eg\_pt\_asmt\_unitusage.assessmentId → eg\_pt\_asmt\_assessment.id
6. **Unit Usage → Assessment Documents** (1:N)
   * One unit usage record can have multiple documents
   * FK: eg\_pt\_asmt\_document.entityid → eg\_pt\_asmt\_unitusage.id

#### Reference Relationships (No FK Constraint)

1. **Assessment → Property** (N:1)
   * Many assessments reference one property
   * Ref: eg\_pt\_asmt\_assessment.propertyId → eg\_pt\_property.id
2. **Document → Entity** (N:1)
   * Documents can be linked to various entities (property, owner, unit)
   * Ref: eg\_pt\_document.entityid → various tables


# Property Tax APIs

## Create New Property

## Creates new property.

> Creates new property with basic information related to land and owner information. Can be integrated with other modules like Water and Sewerage or Trade License to act as base entity against which water connection or trade license can be issued

```json
{"openapi":"3.0.0","info":{"title":"eGov Property Registry System.","version":"1.0.0"},"tags":[{"name":"Property","description":""}],"servers":[{"url":"https://virtserver.swaggerhub.com/egovernmets-faundation/PT-2.0/1.0.0","description":"SwaggerHub API Auto Mocking","variables":{}},{"url":"https://egov-micro-dev.egovernments.org","variables":{}}],"paths":{"/property/_create":{"post":{"tags":["Property"],"summary":"Creates new property.","description":"Creates new property with basic information related to land and owner information. Can be integrated with other modules like Water and Sewerage or Trade License to act as base entity against which water connection or trade license can be issued","operationId":"Createsnewproperty.","parameters":[],"requestBody":{"description":"Details for the new property + RequestHeader meta data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyRequest"}}},"required":true},"responses":{"201":{"description":"Property created sucessfully","headers":{},"content":{"text/plain":{"schema":{"type":"object","description":"Property created sucessfully"}}}},"400":{"description":"Property(s) creation failed"}},"deprecated":false}}},"components":{"schemas":{"PropertyRequest":{"title":"PropertyRequest","type":"object","properties":{"RequestHeader":{"$ref":"#/components/schemas/RequestHeader"},"Property":{"$ref":"#/components/schemas/Property"}},"description":"Contract class to receive request. Array of Property items  are used in case of create . Where as single Property item is used for update"},"RequestHeader":{"title":"RequestHeader","required":["ts","action","msgId"],"type":"object","properties":{"apiInfo":{"$ref":"#/components/schemas/ApiInfo"},"deviceDetail":{"$ref":"#/components/schemas/DeviceDetail"},"ts":{"type":"integer","description":"time in epoch","format":"int64"},"action":{"maxLength":32,"type":"string","description":"API action to be performed like _create, _update, _search (denoting POST, PUT, GET) or _oauth etc"},"key":{"maxLength":256,"type":"string","description":"API key (API key provided to the caller in case of server to server communication)"},"msgId":{"maxLength":256,"type":"string","description":"Unique request message id from the caller"},"requesterId":{"maxLength":256,"type":"string","description":"UserId of the user calling"},"authToken":{"type":"string","description":"//session/jwt/saml token/oauth token - the usual value that would go into HTTP bearer token"},"userInfo":{"$ref":"#/components/schemas/UserInfo"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Hash describing the current RequestHeader"}},"description":"RequestHeader should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestHeader as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseHeader in the response body to ensure correlation."},"ApiInfo":{"title":"ApiInfo","type":"object","properties":{"id":{"maxLength":64,"minLength":2,"type":"string","description":"The id of the API being called"},"version":{"maxLength":64,"minLength":2,"type":"string","description":"The version of the API"},"path":{"type":"string","description":"The URI of the API"}},"description":"Info of the API being called"},"DeviceDetail":{"title":"DeviceDetail","type":"object","properties":{"id":{"type":"string","description":"The id of the device which is trying to accessed"},"signature":{"type":"string","description":"The electronic signature of the device"}},"description":"Contains information about the device used to access the api"},"UserInfo":{"title":"UserInfo","required":["tenantId","userName","primaryrole"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"uuid":{"type":"string","description":"System Generated User id of the authenticated user."},"userName":{"type":"string","description":"Unique user name of the authenticated user"},"password":{"type":"string","description":"password of the user."},"idToken":{"type":"string","description":"This will be the OTP."},"mobile":{"type":"string","description":"mobile number of the autheticated user"},"email":{"type":"string","description":"email address of the authenticated user"},"primaryrole":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"List of all the roles for the primary tenant"},"additionalroles":{"type":"array","items":{"$ref":"#/components/schemas/Additionalrole"},"description":"array of additional tenantids authorized for the authenticated user"}},"description":"This is acting ID token of the authenticated user on the server. Any value provided by the clients will be ignored and actual user based on authtoken will be used on the server."},"Primaryrole":{"title":"Primaryrole","required":["code","tenantId"],"type":"object","properties":{"name":{"maxLength":64,"type":"string","description":"Unique name of the role"},"code":{"maxLength":64,"type":"string","description":"Unique code of the role"},"tenantId":{"maxLength":64,"type":"string","description":"The tenantId for which the role is available"},"description":{"type":"string","description":"brief description of the role"}},"description":"minimal representation of the Roles in the system to be carried along in UserInfo with RequestHeader meta data. Actual authorization service to extend this to have more role related attributes"},"Additionalrole":{"title":"Additionalrole","required":["tenantId","roles"],"type":"object","properties":{"tenantId":{"type":"string","description":"tenantid for the tenant"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"Roles assigned for a particular tenant - array of role codes/names"}},"description":"User role carries the tenant related role information for the user. A user can have multiple roles per tenant based on the need of the tenant. A user may also have multiple roles for multiple tenants."},"Property":{"title":"Property","required":["tenantId","address","propertyType","owners","source"],"type":"object","properties":{"id":{"maxLength":64,"minLength":1,"type":"string","description":"Unique Identifier of the Property for internal reference."},"propertyId":{"maxLength":64,"minLength":1,"type":"string","description":"Unique Identifier of the Property."},"tenantId":{"maxLength":256,"minLength":2,"type":"string","description":"tenant id of the Property"},"surveyId":{"maxLength":256,"minLength":2,"type":"string","description":"survey id of the Property"},"accountId":{"maxLength":64,"minLength":1,"type":"string","description":"UUID of the user to which the property will be associated"},"oldPropertyId":{"maxLength":256,"minLength":1,"type":"string","description":"Old upic no of the Property. ULBs have the existing property in their system/manual records with their identification number, they want to continue the old reference number in this case the same identification number will be captured here."},"status":{"$ref":"#/components/schemas/Status"},"address":{"$ref":"#/components/schemas/Address"},"acknowldgementIds":{"maxLength":64,"minLength":1,"type":"string","description":"Acknowldgement number given to citizen on submitting the application for creation or modification of the property."},"propertyType":{"maxLength":64,"type":"string","description":"Type of a property like Private, Vacant Land, State Government, Central Government etc."},"ownershipCategory":{"maxLength":64,"type":"string","description":"The type of ownership of the property."},"owners":{"type":"array","items":{"$ref":"#/components/schemas/OwnerInfo"},"description":"Property owners, these will be citizen users in system."},"institution":{"$ref":"#/components/schemas/Institution"},"creationReason":{"$ref":"#/components/schemas/CreationReason"},"noOfFloors":{"type":"integer","description":"no of floors in the property","format":"int64"},"landArea":{"type":"number","description":"Land area of the property in sq ft"},"superBuiltUpArea":{"type":"number","description":"super builtup area of the complete property"},"source":{"$ref":"#/components/schemas/Source"},"channel":{"$ref":"#/components/schemas/Channel"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"},"description":"The documents attached by owner for exemption."},"unit":{"$ref":"#/components/schemas/Unit"},"additionalDetails":{"type":"object","description":"The json (array of '#/definitions/Factor')"}}},"Status":{"title":"Status","enum":["ACTIVE","INACTIVE"],"type":"string","description":"status of the Property"},"Address":{"title":"Address","required":["tenantId","locality"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"doorNo":{"type":"string","description":"House number or door number."},"plotNo":{"type":"string","description":"Plot number of the house."},"id":{"type":"string","description":"System generated id for the address"},"landmark":{"type":"string","description":"additional landmark to help locate the address"},"city":{"type":"string","description":"City of the address. Can be represented by the tenantid itself"},"district":{"type":"string","description":"The district in which the property is located"},"region":{"type":"string","description":"The Region in which the property is located"},"state":{"type":"string","description":"The State in which the property is located"},"country":{"type":"string","description":"The country in which the property is located"},"pincode":{"type":"string","description":"PIN code of the address. Indian pincodes will usually be all numbers."},"additionDetails":{"type":"string","description":"more address detail as may be needed"},"buildingName":{"maxLength":64,"minLength":2,"type":"string","description":"Name of the building"},"street":{"maxLength":64,"minLength":2,"type":"string","description":"Street Name"},"locality":{"$ref":"#/components/schemas/Locality"},"geoLocation":{"$ref":"#/components/schemas/GeoLocation"}},"description":"Representation of a address. Indiavidual APIs may choose to extend from this using allOf if more details needed to be added in their case."},"Locality":{"title":"Locality","required":["code","name"],"type":"object","properties":{"code":{"type":"string","description":"code of the boundary."},"name":{"type":"string","description":"name of the boundary."},"label":{"type":"string","description":"localized label for the boundry."},"latitude":{"type":"string","description":"latitude of the boundary."},"longitude":{"type":"string","description":"longitude of the boundary."},"children":{"type":"array","items":{"$ref":"#/components/schemas/Locality"},"description":""},"materializedPath":{"type":"string","description":"materialized path of the boundary - this would be of the format tenantid.[code] from parentt till teh current boundary"}}},"GeoLocation":{"title":"GeoLocation","type":"object","properties":{"latitude":{"type":"number","description":"latitude of the address"},"longitude":{"type":"number","description":"longitude of the address"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"OwnerInfo":{"title":"OwnerInfo","required":["name","mobileNumber","gender","fatherOrHusbandName","relationship"],"type":"object","properties":{"name":{"maxLength":256,"type":"string","description":"The name of the owner."},"mobileNumber":{"maxLength":256,"type":"string","description":"MobileNumber of the owner."},"gender":{"maxLength":256,"type":"string","description":"Gender of the owner."},"fatherOrHusbandName":{"maxLength":256,"type":"string","description":"Father or Husband name of the owner."},"correspondenceAddress":{"maxLength":1024,"type":"string","description":"The current address of the owner for correspondence."},"isPrimaryOwner":{"type":"boolean","description":"The owner is primary or not"},"ownerShipPercentage":{"type":"number","description":"Ownership percentage."},"ownerType":{"maxLength":256,"type":"string","description":"Type of owner, based on this option Exemptions will be applied. This is master data defined in mdms."},"institutionId":{"maxLength":64,"type":"string","description":"The id of the institution if the owner is the authorized person for one"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"},"description":"The documents attached by owner for exemption."},"relationship":{"$ref":"#/components/schemas/Relationship"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated of model"}}},"Document":{"title":"Document","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"system id of the Document."},"documentType":{"type":"string","description":"unique document type code, should be validated with document type master"},"fileStore":{"type":"string","description":"File store reference key."},"documentUid":{"maxLength":64,"type":"string","description":"The unique id(Pancard Number,Adhar etc.) of the given Document."},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}},"description":"This object holds list of documents attached during the transaciton for a property"},"Relationship":{"title":"Relationship","enum":["FATHER","HUSBAND"],"type":"string","description":"The relationship of gaurdian."},"Institution":{"title":"Institution","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"Unique Identifier of the Institution(UUID)."},"tenantId":{"maxLength":256,"type":"string","description":"tenant id of the Property"},"type":{"maxLength":64,"type":"string","description":"Institution type."},"designation":{"maxLength":64,"type":"string","description":"Designation of the person creating/updatingentity on behalf of the institution"},"nameOfAuthorizedPerson":{"maxLength":256,"type":"string","description":"Name of the person who is taking action on behalf of institution"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"CreationReason":{"title":"CreationReason","enum":["NEWPROPERTY","SUBDIVISION"],"type":"string","description":"New property comes into system either property is newly constructed or existing property got sub divided. Here the reason for creation will be captured."},"Source":{"title":"Source","enum":["MUNICIPAL_RECORDS","FIELD_SURVEY"],"type":"string","description":"Source of a constructionDetail data. The constructionDetail will be created in a system based on the data avaialble in their manual records or during field survey. There can be more from client to client."},"Channel":{"title":"Channel","enum":["SYSTEM","CFC_COUNTER","CITIZEN","DATA_ENTRY","MIGRATION"],"type":"string","description":"constructionDetail details can be created from different channels Eg. System (properties created by ULB officials), CFC Counter (From citizen faciliation counters) etc. Here we are defining some known channels, there can be more client to client."},"Unit":{"title":"Unit","type":"object","properties":{"id":{"type":"string","description":"Unique Identifier of the Unit(UUID)."},"tenantId":{"maxLength":256,"minLength":2,"type":"string","description":"tenant id of the Property"},"floorNo":{"maxLength":64,"minLength":1,"type":"string","description":"floor number of the Unit"},"unitType":{"type":"string","description":"Unit type is master data."},"usageCategory":{"maxLength":64,"minLength":1,"type":"string","description":"This is about the usage of the property like Residential, Non-residential, Mixed(Property witch is gettiong used for Residential, Non-residential purpose)"},"occupancyType":{"$ref":"#/components/schemas/OccupancyType2"},"occupancyDate":{"type":"integer","description":"Date on which unit is occupied.","format":"int64"},"constructionDetail":{"$ref":"#/components/schemas/ConstructionDetail"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"OccupancyType2":{"title":"OccupancyType2","enum":["OWNER","TENANT"],"type":"string","description":"Value denoting if the unit is rented or occupied by owner"},"ConstructionDetail":{"title":"ConstructionDetail","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"id of the property with which the constructionDetail is associated."},"carpetArea":{"type":"number","description":"Total built up area in sq ft(built-up area = carpet area + areas covered by walls)"},"builtUpArea":{"type":"number","description":"Total built up area in sq ft(built-up area = carpet area + areas covered by walls)"},"plinthArea":{"type":"number","description":"Area of the extension builtup of the Unit, Like balcony, sitouts."},"superBuiltUpArea":{"type":"number","description":"Total built up area in sq ft(built-up area + Common area = Super built-up area)"},"constructionType":{"maxLength":64,"minLength":1,"type":"string","description":"Construction type is defined in MDMS ConstructionTypeMaster."},"constructionDate":{"type":"integer","description":"The date when the property was constructed","format":"int64"},"dimensions":{"type":"object","description":"The dimensions of the plot or building or any unit"},"auditDetails":{"$ref":"#/components/schemas/AuditDetails"},"additionalDetails":{"type":"object","description":"The json (array of '#/definitions/Factor')"}},"description":"Construction/constructionDetail details are captured here. Detail information of the constructionDetail including floor wise usage and area are saved as seperate units .For each financial year construction details may change. constructionDetail object is required for tax calculation"},"AuditDetails":{"title":"AuditDetails","type":"object","properties":{"createdBy":{"type":"string","description":"username (preferred) or userid of the user that created the object"},"lastModifiedBy":{"type":"string","description":"username (preferred) or userid of the user that last modified the object"},"createdTime":{"type":"integer","description":"epoch of the time object is created","format":"int64"},"lastModifiedTime":{"type":"integer","description":"epoch of the time object is last modified","format":"int64"}},"description":"Collection of audit related fields used by most models"}}}}
```

## Update Existing Property

## Update existing property.

> Updates a given \`Property\` with newer details.

```json
{"openapi":"3.0.0","info":{"title":"eGov Property Registry System.","version":"1.0.0"},"tags":[{"name":"Property","description":""}],"servers":[{"url":"https://virtserver.swaggerhub.com/egovernmets-faundation/PT-2.0/1.0.0","description":"SwaggerHub API Auto Mocking","variables":{}},{"url":"https://egov-micro-dev.egovernments.org","variables":{}}],"paths":{"/property/_update":{"post":{"tags":["Property"],"summary":"Update existing property.","description":"Updates a given `Property` with newer details.","operationId":"Updateexistingproperty.","parameters":[],"requestBody":{"description":"Request header for the property Request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyRequest"}}},"required":true},"responses":{"200":{"description":"Update Property successful","headers":{},"content":{"text/plain":{"schema":{"type":"object","description":"Update Property successful"}}}},"400":{"description":"Update Property failed"}},"deprecated":false}}},"components":{"schemas":{"PropertyRequest":{"title":"PropertyRequest","type":"object","properties":{"RequestHeader":{"$ref":"#/components/schemas/RequestHeader"},"Property":{"$ref":"#/components/schemas/Property"}},"description":"Contract class to receive request. Array of Property items  are used in case of create . Where as single Property item is used for update"},"RequestHeader":{"title":"RequestHeader","required":["ts","action","msgId"],"type":"object","properties":{"apiInfo":{"$ref":"#/components/schemas/ApiInfo"},"deviceDetail":{"$ref":"#/components/schemas/DeviceDetail"},"ts":{"type":"integer","description":"time in epoch","format":"int64"},"action":{"maxLength":32,"type":"string","description":"API action to be performed like _create, _update, _search (denoting POST, PUT, GET) or _oauth etc"},"key":{"maxLength":256,"type":"string","description":"API key (API key provided to the caller in case of server to server communication)"},"msgId":{"maxLength":256,"type":"string","description":"Unique request message id from the caller"},"requesterId":{"maxLength":256,"type":"string","description":"UserId of the user calling"},"authToken":{"type":"string","description":"//session/jwt/saml token/oauth token - the usual value that would go into HTTP bearer token"},"userInfo":{"$ref":"#/components/schemas/UserInfo"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Hash describing the current RequestHeader"}},"description":"RequestHeader should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestHeader as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseHeader in the response body to ensure correlation."},"ApiInfo":{"title":"ApiInfo","type":"object","properties":{"id":{"maxLength":64,"minLength":2,"type":"string","description":"The id of the API being called"},"version":{"maxLength":64,"minLength":2,"type":"string","description":"The version of the API"},"path":{"type":"string","description":"The URI of the API"}},"description":"Info of the API being called"},"DeviceDetail":{"title":"DeviceDetail","type":"object","properties":{"id":{"type":"string","description":"The id of the device which is trying to accessed"},"signature":{"type":"string","description":"The electronic signature of the device"}},"description":"Contains information about the device used to access the api"},"UserInfo":{"title":"UserInfo","required":["tenantId","userName","primaryrole"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"uuid":{"type":"string","description":"System Generated User id of the authenticated user."},"userName":{"type":"string","description":"Unique user name of the authenticated user"},"password":{"type":"string","description":"password of the user."},"idToken":{"type":"string","description":"This will be the OTP."},"mobile":{"type":"string","description":"mobile number of the autheticated user"},"email":{"type":"string","description":"email address of the authenticated user"},"primaryrole":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"List of all the roles for the primary tenant"},"additionalroles":{"type":"array","items":{"$ref":"#/components/schemas/Additionalrole"},"description":"array of additional tenantids authorized for the authenticated user"}},"description":"This is acting ID token of the authenticated user on the server. Any value provided by the clients will be ignored and actual user based on authtoken will be used on the server."},"Primaryrole":{"title":"Primaryrole","required":["code","tenantId"],"type":"object","properties":{"name":{"maxLength":64,"type":"string","description":"Unique name of the role"},"code":{"maxLength":64,"type":"string","description":"Unique code of the role"},"tenantId":{"maxLength":64,"type":"string","description":"The tenantId for which the role is available"},"description":{"type":"string","description":"brief description of the role"}},"description":"minimal representation of the Roles in the system to be carried along in UserInfo with RequestHeader meta data. Actual authorization service to extend this to have more role related attributes"},"Additionalrole":{"title":"Additionalrole","required":["tenantId","roles"],"type":"object","properties":{"tenantId":{"type":"string","description":"tenantid for the tenant"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"Roles assigned for a particular tenant - array of role codes/names"}},"description":"User role carries the tenant related role information for the user. A user can have multiple roles per tenant based on the need of the tenant. A user may also have multiple roles for multiple tenants."},"Property":{"title":"Property","required":["tenantId","address","propertyType","owners","source"],"type":"object","properties":{"id":{"maxLength":64,"minLength":1,"type":"string","description":"Unique Identifier of the Property for internal reference."},"propertyId":{"maxLength":64,"minLength":1,"type":"string","description":"Unique Identifier of the Property."},"tenantId":{"maxLength":256,"minLength":2,"type":"string","description":"tenant id of the Property"},"surveyId":{"maxLength":256,"minLength":2,"type":"string","description":"survey id of the Property"},"accountId":{"maxLength":64,"minLength":1,"type":"string","description":"UUID of the user to which the property will be associated"},"oldPropertyId":{"maxLength":256,"minLength":1,"type":"string","description":"Old upic no of the Property. ULBs have the existing property in their system/manual records with their identification number, they want to continue the old reference number in this case the same identification number will be captured here."},"status":{"$ref":"#/components/schemas/Status"},"address":{"$ref":"#/components/schemas/Address"},"acknowldgementIds":{"maxLength":64,"minLength":1,"type":"string","description":"Acknowldgement number given to citizen on submitting the application for creation or modification of the property."},"propertyType":{"maxLength":64,"type":"string","description":"Type of a property like Private, Vacant Land, State Government, Central Government etc."},"ownershipCategory":{"maxLength":64,"type":"string","description":"The type of ownership of the property."},"owners":{"type":"array","items":{"$ref":"#/components/schemas/OwnerInfo"},"description":"Property owners, these will be citizen users in system."},"institution":{"$ref":"#/components/schemas/Institution"},"creationReason":{"$ref":"#/components/schemas/CreationReason"},"noOfFloors":{"type":"integer","description":"no of floors in the property","format":"int64"},"landArea":{"type":"number","description":"Land area of the property in sq ft"},"superBuiltUpArea":{"type":"number","description":"super builtup area of the complete property"},"source":{"$ref":"#/components/schemas/Source"},"channel":{"$ref":"#/components/schemas/Channel"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"},"description":"The documents attached by owner for exemption."},"unit":{"$ref":"#/components/schemas/Unit"},"additionalDetails":{"type":"object","description":"The json (array of '#/definitions/Factor')"}}},"Status":{"title":"Status","enum":["ACTIVE","INACTIVE"],"type":"string","description":"status of the Property"},"Address":{"title":"Address","required":["tenantId","locality"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"doorNo":{"type":"string","description":"House number or door number."},"plotNo":{"type":"string","description":"Plot number of the house."},"id":{"type":"string","description":"System generated id for the address"},"landmark":{"type":"string","description":"additional landmark to help locate the address"},"city":{"type":"string","description":"City of the address. Can be represented by the tenantid itself"},"district":{"type":"string","description":"The district in which the property is located"},"region":{"type":"string","description":"The Region in which the property is located"},"state":{"type":"string","description":"The State in which the property is located"},"country":{"type":"string","description":"The country in which the property is located"},"pincode":{"type":"string","description":"PIN code of the address. Indian pincodes will usually be all numbers."},"additionDetails":{"type":"string","description":"more address detail as may be needed"},"buildingName":{"maxLength":64,"minLength":2,"type":"string","description":"Name of the building"},"street":{"maxLength":64,"minLength":2,"type":"string","description":"Street Name"},"locality":{"$ref":"#/components/schemas/Locality"},"geoLocation":{"$ref":"#/components/schemas/GeoLocation"}},"description":"Representation of a address. Indiavidual APIs may choose to extend from this using allOf if more details needed to be added in their case."},"Locality":{"title":"Locality","required":["code","name"],"type":"object","properties":{"code":{"type":"string","description":"code of the boundary."},"name":{"type":"string","description":"name of the boundary."},"label":{"type":"string","description":"localized label for the boundry."},"latitude":{"type":"string","description":"latitude of the boundary."},"longitude":{"type":"string","description":"longitude of the boundary."},"children":{"type":"array","items":{"$ref":"#/components/schemas/Locality"},"description":""},"materializedPath":{"type":"string","description":"materialized path of the boundary - this would be of the format tenantid.[code] from parentt till teh current boundary"}}},"GeoLocation":{"title":"GeoLocation","type":"object","properties":{"latitude":{"type":"number","description":"latitude of the address"},"longitude":{"type":"number","description":"longitude of the address"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"OwnerInfo":{"title":"OwnerInfo","required":["name","mobileNumber","gender","fatherOrHusbandName","relationship"],"type":"object","properties":{"name":{"maxLength":256,"type":"string","description":"The name of the owner."},"mobileNumber":{"maxLength":256,"type":"string","description":"MobileNumber of the owner."},"gender":{"maxLength":256,"type":"string","description":"Gender of the owner."},"fatherOrHusbandName":{"maxLength":256,"type":"string","description":"Father or Husband name of the owner."},"correspondenceAddress":{"maxLength":1024,"type":"string","description":"The current address of the owner for correspondence."},"isPrimaryOwner":{"type":"boolean","description":"The owner is primary or not"},"ownerShipPercentage":{"type":"number","description":"Ownership percentage."},"ownerType":{"maxLength":256,"type":"string","description":"Type of owner, based on this option Exemptions will be applied. This is master data defined in mdms."},"institutionId":{"maxLength":64,"type":"string","description":"The id of the institution if the owner is the authorized person for one"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/Document"},"description":"The documents attached by owner for exemption."},"relationship":{"$ref":"#/components/schemas/Relationship"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated of model"}}},"Document":{"title":"Document","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"system id of the Document."},"documentType":{"type":"string","description":"unique document type code, should be validated with document type master"},"fileStore":{"type":"string","description":"File store reference key."},"documentUid":{"maxLength":64,"type":"string","description":"The unique id(Pancard Number,Adhar etc.) of the given Document."},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}},"description":"This object holds list of documents attached during the transaciton for a property"},"Relationship":{"title":"Relationship","enum":["FATHER","HUSBAND"],"type":"string","description":"The relationship of gaurdian."},"Institution":{"title":"Institution","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"Unique Identifier of the Institution(UUID)."},"tenantId":{"maxLength":256,"type":"string","description":"tenant id of the Property"},"type":{"maxLength":64,"type":"string","description":"Institution type."},"designation":{"maxLength":64,"type":"string","description":"Designation of the person creating/updatingentity on behalf of the institution"},"nameOfAuthorizedPerson":{"maxLength":256,"type":"string","description":"Name of the person who is taking action on behalf of institution"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"CreationReason":{"title":"CreationReason","enum":["NEWPROPERTY","SUBDIVISION"],"type":"string","description":"New property comes into system either property is newly constructed or existing property got sub divided. Here the reason for creation will be captured."},"Source":{"title":"Source","enum":["MUNICIPAL_RECORDS","FIELD_SURVEY"],"type":"string","description":"Source of a constructionDetail data. The constructionDetail will be created in a system based on the data avaialble in their manual records or during field survey. There can be more from client to client."},"Channel":{"title":"Channel","enum":["SYSTEM","CFC_COUNTER","CITIZEN","DATA_ENTRY","MIGRATION"],"type":"string","description":"constructionDetail details can be created from different channels Eg. System (properties created by ULB officials), CFC Counter (From citizen faciliation counters) etc. Here we are defining some known channels, there can be more client to client."},"Unit":{"title":"Unit","type":"object","properties":{"id":{"type":"string","description":"Unique Identifier of the Unit(UUID)."},"tenantId":{"maxLength":256,"minLength":2,"type":"string","description":"tenant id of the Property"},"floorNo":{"maxLength":64,"minLength":1,"type":"string","description":"floor number of the Unit"},"unitType":{"type":"string","description":"Unit type is master data."},"usageCategory":{"maxLength":64,"minLength":1,"type":"string","description":"This is about the usage of the property like Residential, Non-residential, Mixed(Property witch is gettiong used for Residential, Non-residential purpose)"},"occupancyType":{"$ref":"#/components/schemas/OccupancyType2"},"occupancyDate":{"type":"integer","description":"Date on which unit is occupied.","format":"int64"},"constructionDetail":{"$ref":"#/components/schemas/ConstructionDetail"},"additionalDetails":{"type":"object","description":"Json object to capture any extra information which is not accommodated by model"}}},"OccupancyType2":{"title":"OccupancyType2","enum":["OWNER","TENANT"],"type":"string","description":"Value denoting if the unit is rented or occupied by owner"},"ConstructionDetail":{"title":"ConstructionDetail","type":"object","properties":{"id":{"maxLength":64,"type":"string","description":"id of the property with which the constructionDetail is associated."},"carpetArea":{"type":"number","description":"Total built up area in sq ft(built-up area = carpet area + areas covered by walls)"},"builtUpArea":{"type":"number","description":"Total built up area in sq ft(built-up area = carpet area + areas covered by walls)"},"plinthArea":{"type":"number","description":"Area of the extension builtup of the Unit, Like balcony, sitouts."},"superBuiltUpArea":{"type":"number","description":"Total built up area in sq ft(built-up area + Common area = Super built-up area)"},"constructionType":{"maxLength":64,"minLength":1,"type":"string","description":"Construction type is defined in MDMS ConstructionTypeMaster."},"constructionDate":{"type":"integer","description":"The date when the property was constructed","format":"int64"},"dimensions":{"type":"object","description":"The dimensions of the plot or building or any unit"},"auditDetails":{"$ref":"#/components/schemas/AuditDetails"},"additionalDetails":{"type":"object","description":"The json (array of '#/definitions/Factor')"}},"description":"Construction/constructionDetail details are captured here. Detail information of the constructionDetail including floor wise usage and area are saved as seperate units .For each financial year construction details may change. constructionDetail object is required for tax calculation"},"AuditDetails":{"title":"AuditDetails","type":"object","properties":{"createdBy":{"type":"string","description":"username (preferred) or userid of the user that created the object"},"lastModifiedBy":{"type":"string","description":"username (preferred) or userid of the user that last modified the object"},"createdTime":{"type":"integer","description":"epoch of the time object is created","format":"int64"},"lastModifiedTime":{"type":"integer","description":"epoch of the time object is last modified","format":"int64"}},"description":"Collection of audit related fields used by most models"}}}}
```

## Fetch Properties List

## Get the list of properties defined in the system.

> Get the properties list based on the input parameters.<br>

```json
{"openapi":"3.0.0","info":{"title":"eGov Property Registry System.","version":"1.0.0"},"tags":[{"name":"Property","description":""}],"servers":[{"url":"https://virtserver.swaggerhub.com/egovernmets-faundation/PT-2.0/1.0.0","description":"SwaggerHub API Auto Mocking","variables":{}},{"url":"https://egov-micro-dev.egovernments.org","variables":{}}],"paths":{"/property/_search":{"post":{"tags":["Property"],"summary":"Get the list of properties defined in the system.","description":"Get the properties list based on the input parameters.\n","operationId":"Getthelistofpropertiesdefinedinthesystem.","parameters":[{"name":"tenantId","in":"query","description":"Unique id for a tenant.","required":true,"style":"form","explode":true,"schema":{"type":"string"}},{"name":"name","in":"query","description":"Name of owner whose property is to be searched.","style":"form","explode":true,"schema":{"type":"string","nullable":true}},{"name":"ids","in":"query","description":"List of system generated ids of properties.","style":"form","explode":true,"schema":{"type":"string"}},{"name":"constructionDetailNumbers","in":"query","description":"List of constructionDetailNumbers to search.","style":"form","explode":true,"schema":{"maxLength":128,"minLength":4,"type":"string"}},{"name":"oldpropertyids","in":"query","description":"List of oldPropertyIds to search..","style":"form","explode":true,"schema":{"maxLength":128,"minLength":4,"type":"string"}},{"name":"mobileNumber","in":"query","description":"MobileNumber of owner whose property is to be searched.","style":"form","explode":true,"schema":{"type":"integer","format":"int64"}},{"name":"fromDate","in":"query","description":"Fetches properties with created time after fromDate.","style":"form","explode":true,"schema":{"type":"number","format":"double"}},{"name":"toDate","in":"query","description":"Fetches properties with created time till toDate.","style":"form","explode":true,"schema":{"type":"number","format":"double"}}],"requestBody":{"description":"RequestHeader meta data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHeader"}}},"required":true},"responses":{"200":{"description":"Successful response","headers":{},"content":{"text/plain":{"schema":{"type":"object","description":"Successful response"}}}},"400":{"description":"Invalid input."}},"deprecated":false}}},"components":{"schemas":{"RequestHeader":{"title":"RequestHeader","required":["ts","action","msgId"],"type":"object","properties":{"apiInfo":{"$ref":"#/components/schemas/ApiInfo"},"deviceDetail":{"$ref":"#/components/schemas/DeviceDetail"},"ts":{"type":"integer","description":"time in epoch","format":"int64"},"action":{"maxLength":32,"type":"string","description":"API action to be performed like _create, _update, _search (denoting POST, PUT, GET) or _oauth etc"},"key":{"maxLength":256,"type":"string","description":"API key (API key provided to the caller in case of server to server communication)"},"msgId":{"maxLength":256,"type":"string","description":"Unique request message id from the caller"},"requesterId":{"maxLength":256,"type":"string","description":"UserId of the user calling"},"authToken":{"type":"string","description":"//session/jwt/saml token/oauth token - the usual value that would go into HTTP bearer token"},"userInfo":{"$ref":"#/components/schemas/UserInfo"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Hash describing the current RequestHeader"}},"description":"RequestHeader should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestHeader as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseHeader in the response body to ensure correlation."},"ApiInfo":{"title":"ApiInfo","type":"object","properties":{"id":{"maxLength":64,"minLength":2,"type":"string","description":"The id of the API being called"},"version":{"maxLength":64,"minLength":2,"type":"string","description":"The version of the API"},"path":{"type":"string","description":"The URI of the API"}},"description":"Info of the API being called"},"DeviceDetail":{"title":"DeviceDetail","type":"object","properties":{"id":{"type":"string","description":"The id of the device which is trying to accessed"},"signature":{"type":"string","description":"The electronic signature of the device"}},"description":"Contains information about the device used to access the api"},"UserInfo":{"title":"UserInfo","required":["tenantId","userName","primaryrole"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"uuid":{"type":"string","description":"System Generated User id of the authenticated user."},"userName":{"type":"string","description":"Unique user name of the authenticated user"},"password":{"type":"string","description":"password of the user."},"idToken":{"type":"string","description":"This will be the OTP."},"mobile":{"type":"string","description":"mobile number of the autheticated user"},"email":{"type":"string","description":"email address of the authenticated user"},"primaryrole":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"List of all the roles for the primary tenant"},"additionalroles":{"type":"array","items":{"$ref":"#/components/schemas/Additionalrole"},"description":"array of additional tenantids authorized for the authenticated user"}},"description":"This is acting ID token of the authenticated user on the server. Any value provided by the clients will be ignored and actual user based on authtoken will be used on the server."},"Primaryrole":{"title":"Primaryrole","required":["code","tenantId"],"type":"object","properties":{"name":{"maxLength":64,"type":"string","description":"Unique name of the role"},"code":{"maxLength":64,"type":"string","description":"Unique code of the role"},"tenantId":{"maxLength":64,"type":"string","description":"The tenantId for which the role is available"},"description":{"type":"string","description":"brief description of the role"}},"description":"minimal representation of the Roles in the system to be carried along in UserInfo with RequestHeader meta data. Actual authorization service to extend this to have more role related attributes"},"Additionalrole":{"title":"Additionalrole","required":["tenantId","roles"],"type":"object","properties":{"tenantId":{"type":"string","description":"tenantid for the tenant"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"Roles assigned for a particular tenant - array of role codes/names"}},"description":"User role carries the tenant related role information for the user. A user can have multiple roles per tenant based on the need of the tenant. A user may also have multiple roles for multiple tenants."}}}}
```

## Delete Existing Property

## Delete existing property.

> The API will delete the property associated with the given propertyId from the system  The API works in idempotent manner.

```json
{"openapi":"3.0.0","info":{"title":"eGov Property Registry System.","version":"1.0.0"},"tags":[{"name":"Property","description":""}],"servers":[{"url":"https://virtserver.swaggerhub.com/egovernmets-faundation/PT-2.0/1.0.0","description":"SwaggerHub API Auto Mocking","variables":{}},{"url":"https://egov-micro-dev.egovernments.org","variables":{}}],"paths":{"/property/_delete":{"post":{"tags":["Property"],"summary":"Delete existing property.","description":"The API will delete the property associated with the given propertyId from the system  The API works in idempotent manner.","operationId":"Deleteexistingproperty.","parameters":[{"name":"tenantId","in":"query","description":"Unique id for a tenant.","required":true,"style":"form","explode":true,"schema":{"type":"string"}},{"name":"propertyId","in":"query","description":"The properrtyId to be deactivated","required":true,"style":"form","explode":true,"schema":{"maxLength":128,"minLength":4,"type":"string"}}],"requestBody":{"description":"Request header for the property delete Request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHeader"}}},"required":true},"responses":{"200":{"description":"Deleted Property successful","headers":{},"content":{"text/plain":{"schema":{"type":"object","description":"Deleted Property successful"}}}},"404":{"description":"Delete Property failed"}},"deprecated":false}}},"components":{"schemas":{"RequestHeader":{"title":"RequestHeader","required":["ts","action","msgId"],"type":"object","properties":{"apiInfo":{"$ref":"#/components/schemas/ApiInfo"},"deviceDetail":{"$ref":"#/components/schemas/DeviceDetail"},"ts":{"type":"integer","description":"time in epoch","format":"int64"},"action":{"maxLength":32,"type":"string","description":"API action to be performed like _create, _update, _search (denoting POST, PUT, GET) or _oauth etc"},"key":{"maxLength":256,"type":"string","description":"API key (API key provided to the caller in case of server to server communication)"},"msgId":{"maxLength":256,"type":"string","description":"Unique request message id from the caller"},"requesterId":{"maxLength":256,"type":"string","description":"UserId of the user calling"},"authToken":{"type":"string","description":"//session/jwt/saml token/oauth token - the usual value that would go into HTTP bearer token"},"userInfo":{"$ref":"#/components/schemas/UserInfo"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Hash describing the current RequestHeader"}},"description":"RequestHeader should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestHeader as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseHeader in the response body to ensure correlation."},"ApiInfo":{"title":"ApiInfo","type":"object","properties":{"id":{"maxLength":64,"minLength":2,"type":"string","description":"The id of the API being called"},"version":{"maxLength":64,"minLength":2,"type":"string","description":"The version of the API"},"path":{"type":"string","description":"The URI of the API"}},"description":"Info of the API being called"},"DeviceDetail":{"title":"DeviceDetail","type":"object","properties":{"id":{"type":"string","description":"The id of the device which is trying to accessed"},"signature":{"type":"string","description":"The electronic signature of the device"}},"description":"Contains information about the device used to access the api"},"UserInfo":{"title":"UserInfo","required":["tenantId","userName","primaryrole"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"uuid":{"type":"string","description":"System Generated User id of the authenticated user."},"userName":{"type":"string","description":"Unique user name of the authenticated user"},"password":{"type":"string","description":"password of the user."},"idToken":{"type":"string","description":"This will be the OTP."},"mobile":{"type":"string","description":"mobile number of the autheticated user"},"email":{"type":"string","description":"email address of the authenticated user"},"primaryrole":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"List of all the roles for the primary tenant"},"additionalroles":{"type":"array","items":{"$ref":"#/components/schemas/Additionalrole"},"description":"array of additional tenantids authorized for the authenticated user"}},"description":"This is acting ID token of the authenticated user on the server. Any value provided by the clients will be ignored and actual user based on authtoken will be used on the server."},"Primaryrole":{"title":"Primaryrole","required":["code","tenantId"],"type":"object","properties":{"name":{"maxLength":64,"type":"string","description":"Unique name of the role"},"code":{"maxLength":64,"type":"string","description":"Unique code of the role"},"tenantId":{"maxLength":64,"type":"string","description":"The tenantId for which the role is available"},"description":{"type":"string","description":"brief description of the role"}},"description":"minimal representation of the Roles in the system to be carried along in UserInfo with RequestHeader meta data. Actual authorization service to extend this to have more role related attributes"},"Additionalrole":{"title":"Additionalrole","required":["tenantId","roles"],"type":"object","properties":{"tenantId":{"type":"string","description":"tenantid for the tenant"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"Roles assigned for a particular tenant - array of role codes/names"}},"description":"User role carries the tenant related role information for the user. A user can have multiple roles per tenant based on the need of the tenant. A user may also have multiple roles for multiple tenants."}}}}
```

## Cancel Existing Property

## Cancel existing property.

> The API will delete the property associated with the given propertyId from the system  The API works in idempotent manner.

```json
{"openapi":"3.0.0","info":{"title":"eGov Property Registry System.","version":"1.0.0"},"tags":[{"name":"Property","description":""}],"servers":[{"url":"https://virtserver.swaggerhub.com/egovernmets-faundation/PT-2.0/1.0.0","description":"SwaggerHub API Auto Mocking","variables":{}},{"url":"https://egov-micro-dev.egovernments.org","variables":{}}],"paths":{"/property/_cancel":{"post":{"tags":["Property"],"summary":"Cancel existing property.","description":"The API will delete the property associated with the given propertyId from the system  The API works in idempotent manner.","operationId":"Cancelexistingproperty.","parameters":[{"name":"tenantId","in":"query","description":"Unique id for a tenant.","required":true,"style":"form","explode":true,"schema":{"type":"string"}},{"name":"propertyId","in":"query","description":"The properrtyId to be deactivated","required":true,"style":"form","explode":true,"schema":{"maxLength":128,"minLength":4,"type":"string"}}],"requestBody":{"description":"Request header for the property delete Request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHeader"}}},"required":true},"responses":{"200":{"description":"Deleted Property successful","headers":{},"content":{"text/plain":{"schema":{"type":"object","description":"Deleted Property successful"}}}},"404":{"description":"Delete Property failed"}},"deprecated":false}}},"components":{"schemas":{"RequestHeader":{"title":"RequestHeader","required":["ts","action","msgId"],"type":"object","properties":{"apiInfo":{"$ref":"#/components/schemas/ApiInfo"},"deviceDetail":{"$ref":"#/components/schemas/DeviceDetail"},"ts":{"type":"integer","description":"time in epoch","format":"int64"},"action":{"maxLength":32,"type":"string","description":"API action to be performed like _create, _update, _search (denoting POST, PUT, GET) or _oauth etc"},"key":{"maxLength":256,"type":"string","description":"API key (API key provided to the caller in case of server to server communication)"},"msgId":{"maxLength":256,"type":"string","description":"Unique request message id from the caller"},"requesterId":{"maxLength":256,"type":"string","description":"UserId of the user calling"},"authToken":{"type":"string","description":"//session/jwt/saml token/oauth token - the usual value that would go into HTTP bearer token"},"userInfo":{"$ref":"#/components/schemas/UserInfo"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Hash describing the current RequestHeader"}},"description":"RequestHeader should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestHeader as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseHeader in the response body to ensure correlation."},"ApiInfo":{"title":"ApiInfo","type":"object","properties":{"id":{"maxLength":64,"minLength":2,"type":"string","description":"The id of the API being called"},"version":{"maxLength":64,"minLength":2,"type":"string","description":"The version of the API"},"path":{"type":"string","description":"The URI of the API"}},"description":"Info of the API being called"},"DeviceDetail":{"title":"DeviceDetail","type":"object","properties":{"id":{"type":"string","description":"The id of the device which is trying to accessed"},"signature":{"type":"string","description":"The electronic signature of the device"}},"description":"Contains information about the device used to access the api"},"UserInfo":{"title":"UserInfo","required":["tenantId","userName","primaryrole"],"type":"object","properties":{"tenantId":{"type":"string","description":"Unique Identifier of the tenant to which user primarily belongs"},"uuid":{"type":"string","description":"System Generated User id of the authenticated user."},"userName":{"type":"string","description":"Unique user name of the authenticated user"},"password":{"type":"string","description":"password of the user."},"idToken":{"type":"string","description":"This will be the OTP."},"mobile":{"type":"string","description":"mobile number of the autheticated user"},"email":{"type":"string","description":"email address of the authenticated user"},"primaryrole":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"List of all the roles for the primary tenant"},"additionalroles":{"type":"array","items":{"$ref":"#/components/schemas/Additionalrole"},"description":"array of additional tenantids authorized for the authenticated user"}},"description":"This is acting ID token of the authenticated user on the server. Any value provided by the clients will be ignored and actual user based on authtoken will be used on the server."},"Primaryrole":{"title":"Primaryrole","required":["code","tenantId"],"type":"object","properties":{"name":{"maxLength":64,"type":"string","description":"Unique name of the role"},"code":{"maxLength":64,"type":"string","description":"Unique code of the role"},"tenantId":{"maxLength":64,"type":"string","description":"The tenantId for which the role is available"},"description":{"type":"string","description":"brief description of the role"}},"description":"minimal representation of the Roles in the system to be carried along in UserInfo with RequestHeader meta data. Actual authorization service to extend this to have more role related attributes"},"Additionalrole":{"title":"Additionalrole","required":["tenantId","roles"],"type":"object","properties":{"tenantId":{"type":"string","description":"tenantid for the tenant"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Primaryrole"},"description":"Roles assigned for a particular tenant - array of role codes/names"}},"description":"User role carries the tenant related role information for the user. A user can have multiple roles per tenant based on the need of the tenant. A user may also have multiple roles for multiple tenants."}}}}
```


# Property Tax Calucator API


# Property Tax System - Functional Specifications

Functional overview for stakeholders

## Introduction

The Property Tax System provides a digital interface to make property assessments, pay property tax, generate payment receipts and monitor tax collection. The citizens can use it, Urban Local Body (ULB) counter field employees and ULB Administrators to accomplish their specific tasks. It is available as a mobile and web-based application.

## Functional Scope

The property tax application features can be broadly classified as the following modules:

1. Registration, Login and Creation of User Profile
2. Filling an Assessment for a Property
3. Searching for a Property
4. Modifications to a Property
5. Generate Demand Notice
6. Payments collection and Receipts
7. Dashboards and Reports
8. General Features

### Registration, Login and Creation of User Profile

{% hint style="warning" %}

* OTP Based Login for Citizens via Web/Mobile App
* OTP Based Login for Employees via Web/Mobile App
* Provision for language selection during first-time registration for both employees and citizens
* Provision of creating a personalized Profile for Citizens and employees on the Web App
* Login Credentials for the various hierarchy of employees
* Role-based access for performing different actions relating to property tax modules
  {% endhint %}

### Filing For Property Assessment

This feature enables citizens and employees to self-assess a new property for a financial year. It helps in registering the property in the system. The details of the property can be entered online and can be assessed for the calculation of the taxes.

The property tax system design is user-friendly and reduces the chances of error. The system calculates the tax automatically and creates the demand. If a user wants to reassess his property for any reason (for example - incorrect data, change in property etc), it can be done by editing the details of the last assessment.

An employee can edit the details of the last assessment, on behalf of the citizen based on the owner’s input. Citizens can track down the status of their incomplete assessment. Any incomplete assessment can be searched and completed.

{% hint style="warning" %}

* Citizen/CSC can assess new property (by different financial years).
* Citizen/CSC can capture Address, Assessment Info, and Owner information for all property types like residential houses, flats and commercial buildings.

o Sample Details captured include -

* Door Number,
* Mutation number,
* Number of floors,
* Area covered,
* Owner and co-owner,
* Mailing & permanent address,
* Built year
* Individual room measurements
* The system computes the property taxes automatically as per state-specific processes and rules.
* The system has a facility to make entries in the system by the inspector after a site visit and assessment of the same by the superintendent.
* The system dynamically calculates the late fees, interest, rebates, etc for demand generation.
* The system fetches the previous year's property data while e-filing the current year to calculate the dues.
* The system assigns a unique property ID based on the process defined in the ULBs.
* Citizen/CSC: View/Print Summary of filled form
* Assessment form
* Assessment form is also sent by email to citizen
* Upload documents
* Ownership/Title related
* ID Proof
* Any other statutory documents
  {% endhint %}

### Searching for a Property

Citizens or employees can track down the status of their incomplete assessment. Any incomplete assessment can be searched and completed.

{% hint style="warning" %}

* Citizens/CSC can search for property using
  * Mobile No
  * City
  * Property Tax Unique ID
* Citizens/ CSC can view incomplete assessments
* Citizens/CSC can reassess searched property
* View property details and pending dues
  {% endhint %}

### Modifications to a Property

The property tax system provides the ability to capture mutation and transfer of ownership. It reduces interfaces between the user and the State and thus promotes greater transparency. It also helps in reducing the time taken for mutation after registration. The system provides the ability for alteration of assessment after verification and inspection. Any structural changes like addition/extension/reduction of existing built-up area or construction type OR utility changes like usage or occupancy impact the increase/decrease in property tax demand. These changes can be handled by the ‘Additional/Alteration of Assessment’ feature.

The system provides the ability for bifurcation/ amalgamation of property. The property bifurcation/ amalgamation undergoes an approval process. The parent property needs to be modified accordingly, which can be done in the system.

{% hint style="warning" %}

* Mutation of property and change of ownership details
* Capture extension/ addition and alteration and reassessment based on changed property details
* Bifurcation of property
* Amalgamation of property
  {% endhint %}

### Generate Demand Notice

The system can automatically generate demand notices for a financial year based on set triggers like time-based rollover on the completion of a financial year. The system notifies the citizens about the demand through SMS/Email. The generated bills can also be grouped and printed for physical distribution by the ULB employees. The system enables employees to merge and download bills based on defined parameters to plan distribution drives.

{% hint style="warning" %}

* Generate demand notice based periodically
* Group demand notices
* Print demand notices
* Cancel demand notices
* Send notifications to citizens on demand generation- SMS, WhatsApp, Email, physical bill
  {% endhint %}

### Payments collection and Receipts

The citizen/ employee can view the payment status of previous assessments from the Assessment History section. It allows users to pay assessment fees fully or partially. Assessment receipts can be downloaded from the assessment history section within the property details.

{% hint style="warning" %}

* Payment of property tax - online, cheque, cash, DD, during assessment
* Partial payment of property tax - online, cheque, cash, DD, during assessment
* The system allows a citizen to pay for anyone's property without changing the demand
* The system can also be integrated with PoS machines to enable doorstep collection of property tax and issue of receipt
  {% endhint %}

### Reports and Dashboards

Property tax reports provide the facility to access the receipt register, cancelled receipt register, account receipt register, ULB-wise PT collection report, and DCB Register. All reports can be downloaded in PDF/XLS format. State-level administrators can monitor property tax collections, assessments and other information at a state level through dashboards.

{% hint style="warning" %}

* State Dashboard: View Reports for Total Collections, Properties Assessed, ULBs on Prod, Usage Type, Payment Distribution
* State Dashboard: PT Collection Timeline (Monthly, Weekly)
* State Dashboard: ULB Wise (Collection, Assessments)
* Cancelled Receipt Register Report
* PT Collection Report (ULB/Date Wise)
  {% endhint %}

### General Features

{% hint style="warning" %}
**Notifications -** The system can send notifications to citizens. These notifications can be sent for various steps like - assessment completion, payment reminder, and payment confirmation. These notifications can be sent in the language chosen by the ULB through all channels - SMS, WhatsApp, and Email.

**Legacy Data Migration -** The system can migrate Demand and Collection. In most states, the preliminary step would be to migrate Legacy data of existing properties/connections along with the Demand and Collection details. This would ensure that subsequent demand generation happens through the system.

**Configurable Masters** - The system provides the following masters that can be configured as per the State’s

**Requirements -**

* Charges & Calculation: Calculation Engine, Rebate, Penalty,
* Rate Master
* State Masters: Property Ontology, Documents List, Employee Data Mapping, Boundary Data Mapping
  {% endhint %}

System specification in compliance with the Ease of Doing Business (EODB) BRAP 2019.

<table><thead><tr><th width="133">Reform No.</th><th>Reform Area</th><th width="108">Weightage (score)</th><th width="282">Recommendation</th><th>Remarks</th></tr></thead><tbody><tr><td>7</td><td>Land administration and Transfer of Land and Property</td><td>3</td><td><p>Digitize land transaction deeds of last 10 years at all sub-registrar offices and make the same available on an online system to check for ownership details and history. The metadata should be searchable for each record and a soft copy of the registered deed should be available. The searchable metadata available should be:</p><p>i. Name of buyer</p><p>ii. Name of seller</p><p>iii. Survey no.</p><p>iv. Registration number</p><p>v. Registration date</p></td><td>The feature of ‘Property Registry’ in the product will enable this recommendation</td></tr><tr><td>8</td><td>Land administration and Transfer of Land and Property</td><td>3</td><td><p>Digitize and publish the updated Record of Rights (ROR) at all Revenue department offices online in public domain for all areas of the State/UT. The searchable metadata available should be:</p><p>i. Name of buyer</p><p>ii. Name of seller</p><p>iii. Date of mutation</p><p>iv. Survey no.</p></td><td>The Property tax system enables this capability</td></tr><tr><td>9</td><td>Land administration and Transfer of Land and Property</td><td>2</td><td><p>Digitize and publish data of Property Tax payment dues online in public domain for all the Urban Local Bodies (ULBs) in the State/UT. The searchable metadata available should be:</p><p>i. Name of the Property Tax payer</p><p>ii. Property Tax dues</p><p>iii. Survey no. of land / Unique Identification no. of property</p></td><td>This feature is enabled by the citizens itself</td></tr><tr><td>10</td><td>Land administration and Transfer of Land and Property</td><td>2</td><td>Digitize cadastral maps of all rural areas in the State/UT and make them available in public domain</td><td>This can be enabled and worked on by the state team</td></tr><tr><td>11</td><td>Land administration and Transfer of Land and Property</td><td>5</td><td><p>Integrate the below-mentioned records on one website:</p><p>i. Data of land transaction deeds for last 10 years at all sub-registrar offices (Name of buyer, Name of seller, Registration number, Registration date, Survey no.),</p><p>ii. Updated Record of Rights at all Revenue department offices (Date of mutation), and</p><p>iii. Data of Property Tax payment dues at all urban areas of the State/UT (Name of the Property Tax payer, Property Tax dues)</p><p>iv. Revenue Court case data (Court case number, Name of parties involved, Date of filing of court case, Status of case [Ongoing/Resolved])</p><p>v. Civil Court case data (Court case number, Name of parties involved, Date of filing of court case, Status of case [Ongoing/Resolved])<br></p><p>The website should be publicly accessible. It will help in establishing property ownership and identify tax encumbrances. The integration should be done for all areas of the State/UT.</p></td><td>The integration with external portals and systems of other departments can be enabled by state teams who can enhance the offered product to cater to this recommendation</td></tr><tr><td>12</td><td>Land administration and Transfer of Land and Property</td><td>2</td><td><p>Implement an online application system having the following features</p><p>i. Mandatory Online application submission including submission of draft deed and other documents</p><p>ii. Provision of online payment of Stamp duty and Registration fee</p><p>iii. Auto generation of appointment date and time on making the payment of Stamp duty and Registration fee</p></td><td>The system will provide these capabilities which can be customised as per the state specific rules and regulations</td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td>13</td><td>Land administration and Transfer of Land and Property</td><td>1</td><td>Provide model deed templates for sale, gift, lease, mortgage and rent in downloadable and editable format along with instructions to use them</td><td>This provision is made available through the ULB portal to make these features accessible to the citizens</td></tr><tr><td>14</td><td>Land administration and Transfer of Land and Property</td><td>2</td><td><p>Integrate the mutation process with the registration process and mandate initiation of mutation process (Revenue department and/ or ULB) as soon as the deed is registered. Ensure that:</p><p>i. Information to mutation authority to be automatically shared on completion of transaction (registration). This should be considered as initiation of mutation process.</p><p>ii. No separate application from transferee to be required.</p><p>iii. SMS/email should be sent to transferee/ transferor to inform about the initiation of mutation</p></td><td>The integration with external portals and systems of other departments can be enabled by state teams who can enhance the offered product to cater to this recommendation</td></tr></tbody></table>

**List of Features- Property Tax**

<table><thead><tr><th width="387">List of Functionalities</th><th>Corresponding Features</th></tr></thead><tbody><tr><td>Registration, Login, Creation of User Profile</td><td>Provision for Language Selection during first time registration via Mobile/ Web App.</td></tr><tr><td>OTP Based Login for Citizen/ Employee via Mobile/ Web App</td><td></td></tr><tr><td>Login Credentials for various hierarchy of employees.</td><td></td></tr><tr><td>Provision of Personalized Profile for Citizen/ Employee on Web App</td><td></td></tr><tr><td>Filing an assessment for a property</td><td>Citizen/CSC : Assess New Property (By Different Financial Years).</td></tr><tr><td>Citizen/CSC : Capture Address, Assessment Info, Owner Info.</td><td></td></tr><tr><td>Citizen/CSC : View/Print Summary of Filled Form</td><td></td></tr><tr><td>Searching for a property</td><td>Citizen/CSC : Search Property (By Mobile No,City, Property Tax Unique ID, Existing ID).</td></tr><tr><td>Citizen/CSC : View the Searched Property</td><td></td></tr><tr><td>Citizen : View My Properties</td><td></td></tr><tr><td>Citizen : View Incomplete Assessments</td><td></td></tr><tr><td>Citizen/CSC : Edit the Searched Property</td><td></td></tr><tr><td>Citizen/CSC : Reassess Searched Property</td><td></td></tr><tr><td>Generate demand notice</td><td>Generate Demand Notice based on periodic basis</td></tr><tr><td>Group/ Print/ Cancel Demand Notices</td><td></td></tr><tr><td>Send notifications to citizens on demand generation- SMS, Whatsapp, Email, Physical bill</td><td></td></tr><tr><td>Modifications to a property</td><td>Mutation of property and change of ownership details</td></tr><tr><td>Capture Extension/ Addition and Alteration and reassessment based on changed property details</td><td></td></tr><tr><td>Bifurcation/ Amalgamation of property</td><td></td></tr><tr><td>Payment collection and receipts</td><td>Payment of TAX (Online,Cheque,Cash,DD) : During Assessment</td></tr><tr><td>Payment of TAX (Online,Cheque,Cash,DD) : Partial Payment</td><td></td></tr><tr><td>Citizen/CSC : Download Receipts for payments</td><td></td></tr><tr><td>Dashboards and reports</td><td>State Dashboard : View Reports for Total Collections, Properties Assessed, ULBs on Prod, Usage Type, Payment Distribution</td></tr><tr><td>State Dashboard : PT Collection Timeline (Monthly,Weekly)</td><td></td></tr><tr><td>State Dashboard : ULB Wise (Collection, Assessments)</td><td></td></tr><tr><td>Cancelled Receipt Register Report</td><td></td></tr><tr><td>PT Collection Report (ULB/Date Wise)</td><td></td></tr><tr><td>General features</td><td>Notification</td></tr><tr><td>Legacy data migration</td><td></td></tr><tr><td>System assigns a unique property ID based on the Process defined in the ULBs.</td><td></td></tr><tr><td>System has the facility to classify the property based on its type.</td><td></td></tr><tr><td>System allows changing the type of property.</td><td></td></tr><tr><td>Configuration masters</td><td>Configurable Rate Master (ULB Specific) : Fire Cess/ Building Height</td></tr><tr><td>Charges &#x26; Calculation : Calculation Engine, Rebate, Penalty</td><td></td></tr><tr><td>State Masters : Property Ontology, Documents List, Employee Data Mapping, Boundary Data Mapping</td><td></td></tr></tbody></table>


# Property Tax System - Product Requirements Document


# Property Amalgamation

Product requirements document for amalgamation of properties

## Introduction

**What does amalgamation of properties mean?**

Two or more than two adjacent properties of an owner(s) are merged to form a single property. On merging of properties, merged properties are removed from the assessment registers while the retaining property is modified to add the merged property(ies) dimensions. The retaining and merged properties relationship is maintained for future reference. The combination of properties for which amalgamation can be done is given below.&#x20;

* Building + Building&#x20;
* Building + Vacant Land&#x20;
* Vacant Land + Vacant Land

**How is the amalgamation of properties accomplished on the ground?**

The amalgamation is considered a service and the owner(s) has to apply for it. A single application is created for the amalgamation of properties with details of all the properties and the required documents are produced in support of the application. There is no application/ processing fee associated with the amalgamation of properties.

## Key Metrics&#x20;

Below are state-wise approximate figures of amalgamation applications received and processed in a year.

<table><thead><tr><th width="207">State</th><th width="438.66666666666663">Basis</th><th># Applications</th></tr></thead><tbody><tr><td>Andhra Pradesh</td><td>[On basis of data available in the property tax system]</td><td>453</td></tr><tr><td>Punjab</td><td>[On the basis of application received manually]</td><td>3000</td></tr><tr><td>Uttarakhand</td><td>[On the basis of application received manually]</td><td>1500</td></tr><tr><td>Cantonment Boards</td><td>[On the basis of application received manually]</td><td>1000</td></tr><tr><td>Odisha</td><td>[On the basis of application received manually]</td><td>NA</td></tr></tbody></table>

## Proposed Solution&#x20;

**How to achieve this with the Property Tax System?**

1. A new application type ‘AMALGAMATION’ is created.&#x20;
2. Application no. format is defined.&#x20;
3. Only one application is created and the record of the same is maintained. All the properties involved in amalgamation are linked to that application.&#x20;
4. Workflow components are integrated and the wf status of retaining and merge properties are maintained as ‘In Workflow’ while the application is in flow.&#x20;
5. Though there are no instances observed where the application fee is charged for amalgamation, the applicability of the application fee is to be made configurable.&#x20;
6. The uniqueness of the owner (Individual) is identified based on the below-given attributes.&#x20;
   * Owner’s Name&#x20;
   * Owner’s Gender&#x20;
   * Owner’s Guardian Name&#x20;
   * Relationship with Guardian&#x20;
7. The uniqueness of the owner (Institutional) is identified based on the below-given attributes.&#x20;
   * Institute Name&#x20;
   * Institute Type&#x20;
   * Authorised Person Name&#x20;
8. No final document is generated as proof of amalgamation.&#x20;
9. Applicant(s) is/are intimated through SMS/ email notifications about the status and completion of the application.&#x20;
10. Any integration impact to be handled.&#x20;
    * Water and sewerage connection with merging properties to be moved to retaining property or to be brought to closure.&#x20;
    * Trade licenses associated with merging properties are to be moved to retaining property or to be brought to closure.&#x20;
11. Modules linked with property tax have to expose the API to check the status of applications in respective modules associated with a property.

## **Validations**

1. All the properties should be active, INACTIVE and WORKFLOW properties are not eligible for amalgamation.&#x20;
2. There should be any application in flow for other services as well linked with a merging property. E.g. Water Connection, Sewerage Connection, and Trade License.&#x20;
3. The owner (s) of the retaining property should always be a superset of the owner(s) of the merging property. It means there should not be a case where any owner of the merging property(ies) is not the one from the owners of the retaining property.&#x20;
4. There should not be any due on the properties which are to be merged while there is no such condition for retaining property.&#x20;
5. Dues related to water and sewerage charges for the connections associated with merging properties are not taken care of here.&#x20;
6. The total land area of retaining property = Land area of retaining + Total land area of properties to be merged.&#x20;
7. The total built-up area of retaining property = Built-up area of retaining + Total built-up area of properties to be merged.&#x20;
8. Properties to be merged are deactivated on completion of the process while retaining property remains active.&#x20;
9. Amalgamation will be effective from the date of approval of the application.

## Integrations Impacts&#x20;

### Water and Sewerage

1. There should not be an application related to water connection linked with a merging property in the workflow.&#x20;
2. In the case of water and sewerage connections associated with merging property to be moved to retaining property, it has to be achieved in the WnS module itself by modifying the connection.&#x20;
3. In the case of water and sewerage connections associated with merging property to be closed, it has to be achieved in the WnS module itself by using closure connection activity.

### Trade Licenses

1. In the case of trade licenses associated with merging properties to be moved to retaining property, it has to be achieved in the TL module itself on renewal of trade.&#x20;
2. In the case of trade licenses associated with merging properties to be closed, it has to be achieved in the TL module itself by using the closure of trade features.

### Accounting and Finance&#x20;

Accounting entries are passed for these transactions in terms of demand modifications.

## **User Persona**

| As a \<Role>            | I want \<What>                                        | So that \<Why>                                                                       |
| ----------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Employee/Citizen**    | Search a property by unique property ID               | I can create an application for amalgamation of property(ies)                        |
| **Employee/Citizen**    | Search a property by owner’s mobile no.               | I can create an application for amalgamation of property(ies)                        |
| **Employee/Citizen**    | Search a property by owner’s name or by door no.      | I can create an application for amalgamation of property(ies)                        |
| **Employee/Citizen**    | Initiate new application for properties amalgamation  | I can merge adjunct property(ies) into main property.                                |
| **Citizen**             | Notification for my property amalgamation application | I can keep track of my application (notification sent will be according to workflow) |
| **Employee (Workflow)** | Amalgamation application in my inbox                  | I can take appropriate action on the application.                                    |
| **Employee**            | Search application                                    | I can see the application details.                                                   |
| **Citizen**             | My Applications                                       | I can see the application details to keep track of the application.                  |

## Navigation&#x20;

**Employee**&#x20;

Login → Search Property → View Property Details → Select ‘Amalgamation’ Action

**Citizen**&#x20;

Login → Amalgamation Menu → Search Property → Search Result → Select Property.

**Application No. Format**&#x20;

Application No. should follow the given format. PT-\<running sequence>

**User Flow**

Citizen/ Counter Employee - Application is initiated by citizen/ counter employee.&#x20;

Document Verification - The application and documents attached to it are verified by a document verifier.&#x20;

Field Inspection - The field inspector performs the field visit for the physical verification of properties.&#x20;

Approval of Application - The application is approved by the approver and the changes requested in the application come into effect in case the application fee is not applicable.&#x20;

Payment of application fee - In the case the application fee is applicable, the changes related to amalgamation come into effect only after the payment of the application fee.

<figure><img src="/files/dsCpYossDIH7aew6RLDu" alt=""><figcaption></figcaption></figure>

### **Application Form** <a href="#application-form" id="application-form"></a>

| Field Name                            | Data Type   | Is Mandatory? | Description                                                                               |
| ------------------------------------- | ----------- | ------------- | ----------------------------------------------------------------------------------------- |
| **Property Address**                  |             |               |                                                                                           |
| Pincode                               | Display     | Yes           | Pincode of area property is located.                                                      |
| City                                  | Display     | Yes           | City name of the property.                                                                |
| Locality/Mohalla                      | Display     | Yes           | Locality or mohalla name property is located.                                             |
| Street Name                           | Display     | Yes           | Street name property is located.                                                          |
| Door No./House No.                    | Display     | Yes           | House or door no. of the property.                                                        |
| **Ownership Details**                 |             |               |                                                                                           |
| Ownership Type                        | Display     | Yes           | Display of ownership type.                                                                |
| Institution Name                      | Display     | Yes           | It is applicable for the ownership type institution.                                      |
| Institution Type                      | Display     | Yes           | It is applicable for the ownership type institution.                                      |
| Name                                  | Display     | Yes           | Name of the owner of property or the authorised person in case of institutional property. |
| Guardian Name                         | Display     | Yes           | Name of guardian and applicable for single and multiple ownership type only.              |
| Gender                                | Display     | Yes           | Gender of owner/authorised person of the property.                                        |
| Landline No.                          | Display     | Yes           | Office landline no. in case of institutional ownership.                                   |
| Mobile No.                            | Display     | Yes           | Mobile no. of the owner/ authorised person.                                               |
| Designation                           | Display     | Yes           | Designation of the authorised person                                                      |
| Email                                 | Display     | Yes           | Email address of owner/ authorised person.                                                |
| Corresponding Address                 | Display     | Yes           | Corresponding address of the owner/ authorised person.                                    |
| **Merge Propertie(s)**                |             |               |                                                                                           |
| Property ID                           | Textbox     | Yes           | To search and add the property. A button with the label ‘Search and Add’.                 |
| Search Property                       | Hyperlink   | Yes           | To search the property by other params too and add it to the application.                 |
| **Property 1**                        |             |               |                                                                                           |
| Property ID                           | Display     | Yes           | Unique Property ID.                                                                       |
| Property Address                      | Display     | Yes           | Full address of property.                                                                 |
| Property Owners                       | Display     | Yes           | Comma separated list of property owners.                                                  |
| View Property Details/Remove Property | Hyperlink   | Yes           | To view the completed property details/ remove the added property.                        |
| **Assessment Details**                |             |               |                                                                                           |
| Property Type                         | Drop-down   | Yes           | Type of property                                                                          |
| Property Usage                        | Drop-down   | Yes           | Usage of property, residential, non-residential, or mixed.                                |
| Plot Size (In Sq Ft)                  | Textbox     | Yes           | Total area of land in square feet on which the property is constructed.                   |
| **Unit 1**                            |             |               |                                                                                           |
| Floor No.                             | Drop-down   | Yes           | Floor no. unit is located.                                                                |
| Usage                                 | Drop-down   | Yes           | Usage of unit, residential/ non-residential.                                              |
| Sub-Usage                             | Drop-down   | Yes           | Sub-usage of unit, mandatory in case of non-residential usage.                            |
| Occupancy                             | Drop-down   | Yes           | The type of occupancy of property.                                                        |
| Annual Rent                           | Textbox     | Yes           | Annual rent in INR, in case property is rented out.                                       |
| Built-up Area                         | Textbox     | Yes           | Built-up area of the unit in square feet.                                                 |
| Documents                             | File Picker | Yes           | The documents required to process the request.                                            |
| Timelines                             | Workflow    | Yes           | Display of workflow steps completed.                                                      |

### **Workflow**

| Action               | Role                       | From State                        | To State                          |
| -------------------- | -------------------------- | --------------------------------- | --------------------------------- |
| Initiate Application | Citizen/ Counter Employee  |                                   | Initiated                         |
| Submit Application   | Citizen/ Counter Employee  | Initiated                         | Pending for document verification |
| Verify and Forward   | Document Verifier          | Pending for document verification | Pending for field inspection      |
| Verify and Forward   | Field Inspector            | Pending for field inspection      | Pending approval for amalgamation |
| Send Back            | Document Verifier          | Pending for document verification | Pending for citizen action        |
| Send Back            | Field Inspector            | Pending for field inspection      | Pending for document verification |
| Send Back            | Approver                   | Pending approval for amalgamation | Pending for field inspection      |
| Send Back To Citizen | **\<roles having access>** | **\<Current Status>**             | Pending for citizen action        |
| Re-submit            | Citizen/ Counter Employee  | Pending for citizen action        | Pending for document verification |
| Re-submit            | Document Verifier          | Pending for document verification | Pending for field inspection      |
| Re-submit            | Field Inspector            | Pending for field inspection      | Pending approval for amalgamation |
| Approve              | Approver                   | Pending approval for amalgamation | Approved                          |
| Reject               | **\<roles having access>** | **\<Current Status>**             | Rejected                          |

### Wireframes&#x20;

Please click here to see the wireframes in Figma.&#x20;

Screenshots are attached below.&#x20;

### Citizen (Mobile First)

Apply for amalgamation

| <p></p><p><img src="/files/VjoFgSAtpoiAwmIS1WMf" alt="" data-size="original"></p> | <p></p><p><img src="/files/hkZbfbHFf1OADBuXXej1" alt="" data-size="original"></p> |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |

Login into the account (If not already logged in)

| <p></p><p><img src="/files/WuiYeG3DeYEwuBOfas2z" alt="" data-size="original"></p> | <p></p><p><img src="/files/4pazhUbz7zJTohIkx7ZQ" alt="" data-size="original"></p> |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |

Select retaining the property for amalgamation&#x20;

The user will be displayed all the properties currently linked with the logged-in account and allowed to select one of them as a retaining property.

| <img src="/files/CkZ02hfxOoX9G28j9x5B" alt="" data-size="original"> | <img src="/files/VN39Cz2w7RndkU97hXn2" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

The retaining property address and ownership details are displayed on the apply screen.

| <img src="/files/FPVZoebUspro31O4SR7r" alt="" data-size="original"> | <img src="/files/yK2qolnTDKU5M0qxbv6X" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

Select a property to merge.

The user will be displayed a list of all those properties which are owned by him/ her as a single owner or joint owner and allowed to select a property based on the below conditions. The owner(s) of the merging property should be a subset of the owner(s) of the retaining property.&#x20;

* There should not be any dues on the property.&#x20;
* The property should be active, **also there should not be any application in flow for an integrated module associated with the property.**&#x20;
* The property should belong to the same locality as the retaining property.

| <img src="/files/CjqXuyOY5zMeMAEPN7HX" alt="" data-size="original"> | <img src="/files/b2kYKMOw04IbLtTY6CsO" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

Modify the assessment details of retaining property&#x20;

* Property Type&#x20;
* Plot Size

| <img src="/files/pYaxe3kVFVrcLwEbclyL" alt="" data-size="original"> | <img src="/files/Ag7RGAnxwFkPGtiH03rC" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

* Number of basements&#x20;
* Number of floors

| <img src="/files/8FESeDYEt7EzID4SvtQN" alt="" data-size="original"> | <img src="/files/gJPO3XbIlINEq3qLaEC2" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |

Unit details&#x20;

* Usage&#x20;
* Sub-usage&#x20;
* Occupancy&#x20;
* Built-up Area&#x20;
* Annual Rental

| <img src="/files/eYphKkB3dF3J0on6XL45" alt="" data-size="original"> | <img src="/files/mRab5UvrLyau9hM6VVTW" alt="" data-size="original"> | <img src="/files/D7nXx8fbZhWhnD0ogdCU" alt="" data-size="original"> |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |

In case, the property type is ‘Flat’, the flat details are modified.

<figure><img src="/files/MSV57zRDzZgMNmMfdTg9" alt=""><figcaption></figcaption></figure>

In the case property type is vacant land, vacant land details are modified.

<div align="left"><figure><img src="https://lh4.googleusercontent.com/drLwE5wx93-H50p5FJZL8JiPBWugfi2BMPaXWAe4kZwdRLx_qUxyx8mA9z2nKve6bgI-irsjd1Gz0wXOL161Pe9ESW_gqharBIdrff-KiAHpMlbGf8Je_gRDUVy3Qwdmes1xnaoFNrL3nSbKvXqkyivOsumYD9hHZ4Rh8nkQHNVVUNarDhfU4pNO" alt=""><figcaption></figcaption></figure></div>

Documents attachment and summary of the application

<div align="left"><figure><img src="https://lh6.googleusercontent.com/FzYpT4agDDCHYz6kEkSKBgNZhbr4RcEWHqOOyPUA_lnRIGjxlywNFG-vruOy72SERphC7O2ZYfWLg8-xhYSjvt5c20b4GJ62CV09Pz8a6HULDfmz1WSEOlVFVWJqgxsV6_53N02DsJW-35zkXbrFbzVNe3T7CyX1GN-0pmSzGbhRUk5msbfycY22" alt=""><figcaption></figcaption></figure></div>

![](/files/42n07Wq8ssKPaUraDzLs)![](/files/bAea9255CeZ3I2Df9Yoe)

### Employee

**Apply for amalgamation**

Property is searched and property details are viewed.​​​​

<figure><img src="/files/rE8KOCLci1depggy2hID" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/WYkcrRmZfB5dUWez0bcN" alt=""><figcaption></figcaption></figure>

Select the action ‘Amalgamate Property’ from the action list.​​​​​​​​​​

<figure><img src="/files/TnPZbOnfW86jcUDKNttN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GxiNK8eQe0FlNF6qbhdh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/22JgAznlaPIYwkuJZavc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/h6fkN4yJay0VTgar2Kzh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NjOOLRkQx5M9VbjAOEud" alt=""><figcaption></figcaption></figure>

## Use Case Scenarios

**UC 1 - Same Owner’s Residential Properties**

There are two properties A and B, both are residential in nature and belong to the same owner “xyz”.

Illustration: Suppose A is the retaining property while B has to be merged with A.

* Property A address remains unchanged.
* Property A ownership details remain unchanged.

So assessment details of property A are modified according to the assessment details of B. Below given are the activities which can be performed to modify the assessment detail of property A.

* The land area of A is increased to include B into A.
* One more UNIT is added to A representing B.
* An additional floor is added to A representing B.
* The existing UNIT area of A is increased.
* The existing UNIT rental value of A is increased.
* The remaining attributes would remain unchanged. Like Usage, Sub Usage, and Occupancy. Though these also can be edited if required.

Property B is linked with the application which is deactivated on completion.

**UC 2 - Same Owner’s Mixed Properties**

There are two properties A and B, A is residential while B is non-residential and belongs to the same owner “xyz”.Illustration: Suppose A is the retaining property while B has to be merged with A.

* Property A address remains unchanged.
* Property A ownership details remain unchanged.
* So assessment details of property A are modified according to the assessment details of B. Below given are the activities which can be performed to modify the assessment detail of property A.
  * The land area of A is increased to include B into A.
  * Property usage is changed to Mixed.
  * One more UNIT is added to A representing B and UNIT usage and sub-usage is kept according to property B, commercial in this case.
  * An additional floor is added to A representing B.
  * The existing UNIT area of A is increased.
  * The existing UNIT rental value of A is increased.
* Property B is linked with the application which is deactivated on completion.

**UC 3 - Solo Owner Of One Property And Joint Of Others**

There are two properties A and B, “xyz” is the only owner of property A while he/she is the joint owner of property B.Illustration:

* In case, property B is the retaining property, property A is merged according to usage cases #1 and #2.
* In case, property A is the retaining property, property B is first mutated in the name of the owners of property A using the mutation process.

**UC 4 - Properties Of Two Different Owners**

There are two properties A and B, the owner of property A is “xyz” while the owner of property B is “def”.Illustration:

* In case A is going to be retaining property, property B is to be first mutated in the name of “xyz” using the mutation process.
* In case B is going to be retaining property, property A to be first mutated in the name of “def” using the mutation process.

There are two properties A and B, the owner of property A is “xyz” which is institutional ownership while the owner of property B is “def” which is individual ownership.

* It is a similar case to #4, and the property is to be mutated first to initiate amalgamation.


# Capital Value System

## Objective

The objective of this document is to compare the capital value method of property tax assessment with other available methods i.e. annual rental value and unit area value method and evolve the approach to incorporate the capital value system in DIGIT with bare minimum changes.&#x20;

## Source of Information

Uttarakhand  - Draft for capital value system, IGRS system study.

Andhra Pradesh - Draft for capital value system, IGRS system study.

## Abbreviation&#x20;

<table><thead><tr><th width="247">Acronym</th><th>Value</th></tr></thead><tbody><tr><td>ARVM</td><td>Annual Rental Value Method</td></tr><tr><td>UAVM</td><td>Unit Area Value Method</td></tr><tr><td>CVM</td><td>Capital Value Method</td></tr><tr><td>IGRS</td><td>Inspector General of Registration and Stamps</td></tr><tr><td>CV</td><td>Capital Value</td></tr></tbody></table>

## Process Overview

The process of assessment of property tax will remain the same as the UAV method for assessment of property tax.

### Methods of property tax assessment

There are broadly 3 methods which are being used for property tax assessment.

1. Annual Rental Value - In this method tax is calculated on the annual rental value.
2. Unit Area Value  - In this method tax is calculated on annual value.
3. Capital Value - In this method tax is calculated on capital value.

DIGIT already supports the first 2 methods of property tax assessment while the capital value method is relatively new and needs to be incorporated into DIGIT. DIGIT to provide the configuration to define the method of assessment of property tax upfront.

## Masters Data&#x20;

### State Level Masters

DIGIT already supports masters which are required to calculate the annual rental/ annual value. Below given table illustrates which of those are relevant for the capital value method.

<table><thead><tr><th width="205.33333333333331">ARVM/UAVM</th><th width="190">CVM</th><th>Comments</th></tr></thead><tbody><tr><td>Property Type</td><td>Property Type</td><td>It is to define the structure of property as a property would be a vacant land, or a building.</td></tr><tr><td>Property Usage</td><td>Property Usage</td><td>It is upto 3 levels of categorization of usage of a property.</td></tr><tr><td>Floors</td><td>Floors</td><td>It is to define the floors e.g. Ground Floor, First Floor etc.</td></tr><tr><td>Occupancy</td><td>Not Applicable</td><td>Occupancy defines whether a property is occupied by the owner itself or rented out to a tenant.</td></tr><tr><td>Ownership Type</td><td>Ownership Type</td><td>It is upto 2 levels of categorization of ownership of a property.</td></tr><tr><td>Owner’s Category</td><td>Owner’s Category</td><td>It is a category of owner based on which owner would be eligible for certain exemption on property tax. E.g. Freedom Fighter,  Army Personal etc.</td></tr><tr><td>Construction Type</td><td>Construction Type</td><td>It is to define the consumption category of a building. A building would be a Pakka, Kachha or Semi Pakka etc. </td></tr><tr><td>Not Applicable</td><td>Distance From Road</td><td>Distance of the building from the main road plays the role to calculate the capital value. It is applicable to vacant land properties only.</td></tr></tbody></table>

### ULB Specific Masters

#### Boundaries

ULBs are divided into definite smaller units of boundaries to define the unit/ rental rates. In the same way, boundaries are defined by the registration and stamp duty department to define the circle rates. DIGIT has to provide the option to define the boundaries from the registration and stamp duty department.

District → SRO → Block or Segment

<table><thead><tr><th width="180.33333333333331">ARVM/UAVM</th><th width="159">CVM</th><th>Comments</th></tr></thead><tbody><tr><td>ULB</td><td>ULB</td><td>It is to define the ULB with all its attributes like District, Address, Grade etc.</td></tr><tr><td>Ward</td><td>Not Applicable</td><td>All the ULBs in the state have only one boundary hierarchy i.e. Admin Boundary which is used for both Revenue and Administration purposes. Ward is the smallest boundary in this hierarchy and placed at second level just below the ULB boundary itself.</td></tr><tr><td>Locality</td><td>Not Applicable</td><td>Locality or Mohalla is the smallest boudry unit within the ULB which defines the state of the bounded area. So a locality would be specified as posh, modest, slum etc. and the rares are defined accordingly. Rental and Unit Area rates are defined based on the locality.</td></tr><tr><td>Not Applicable</td><td>SRO</td><td>Name of sub registrar office within the given district. For smaller cities there is only one SRO.</td></tr><tr><td>Not Applicable</td><td>Segment/ Block</td><td>Localities are further segmented into multiple blocks to define the circle rates.</td></tr></tbody></table>

#### Cross Boundaries Mapping

1. ULB - SRO mapping - It is mandatory to have and list the SROs on the screen linked with a ULB.
2. Locality - Segment/ Block mapping - It is nice to have, but not mandatory. Having this mapping will make the segment/ block list refined to be selected by the applicant.

### Fee, Rates, Penalty and Rebates

<table><thead><tr><th width="170.33333333333331">ARVM/UAVM</th><th width="178">CVM</th><th>Comments</th></tr></thead><tbody><tr><td>Rental Rates</td><td>Not Applicable</td><td>Rental rates are generally defined based on the locality, usage, and the construction type of the property.</td></tr><tr><td>Unit Rates</td><td>Not Applicable</td><td>Rental rates are generally defined based on the locality, usage, and the construction type of the property.</td></tr><tr><td>Not Applicable</td><td>Circle Rates</td><td>Circle rates are generally defined based on the Segment or Block, Usage, Property Type, Construction Type, and Distance of property from the road.</td></tr><tr><td>Tax Rates</td><td>Tax Rates</td><td><br></td></tr><tr><td>Penal Interest</td><td>Penal Interest</td><td><br></td></tr><tr><td>Penalties</td><td>Penalties</td><td><br></td></tr><tr><td>Rebates</td><td>Rebates</td><td><br></td></tr></tbody></table>

## Property Attributes

Below given table lists all the fields/attributes which are captured to record the property detail and use for various purposes like assessing the property tax using the current capital value of the property, generating the demand bills, locating the property, and sending the notification to owners of property etc.

### Location Details

ARV and UAV-specific boundaries are not applicable for the calculation of capital value. CVS has a completely different set of boundaries used by the registration and stamp duty department to define the circle rates and the same is given below. SRO and Block are to be added to the location detail of the property to enable CVM.

<table><thead><tr><th width="151">Field Name</th><th width="140">Field Type</th><th width="155">Is Mandatory</th><th>Comments</th></tr></thead><tbody><tr><td>Pincode</td><td>Textbox</td><td>No</td><td>Pincode of the locality property belongs to. Though it is non-mandatory.</td></tr><tr><td>Locality</td><td>Dropdown</td><td>Yes</td><td>Locality to which property belongs to. It is internally mapped to ward and ULB boundary. </td></tr><tr><td>Street Name</td><td>Textbox</td><td>No</td><td>Street name on which property is situated.</td></tr><tr><td>Door No.</td><td>Textbox</td><td>Yes</td><td>It is mandatory for Buildings and Flats</td></tr><tr><td>SRO</td><td>Dropdown</td><td>Yes</td><td>SRO will be populated based on the district of ULB.</td></tr><tr><td>Block/ Segment</td><td>Dropdown</td><td>Yes</td><td>It is a non-editable field. It is populated on SRO selected and cross hierarchy mapping if it exists.</td></tr></tbody></table>

### Construction Details

In the construction detail, occupancy of the property is irrelevant for the calculation of the property’s capital value while other masters like property type, usage, nature of business, and the construction type are used as it is. However, there would be changes in that the values are a little bit different and defined according to the registration and stamp duty department.

### Ownership Details

No change is required in existing ownership details.

### Required Documents

Documents which are required to avail of the service are already configurable.

**Property**

**Property Registration From (UI)**

<figure><img src="/files/Rj8SGuiUKyuh5d1gu2OS" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh5.googleusercontent.com/AiE0yyMUKTVD7d5MuP5Wp3pnhR68MgbnSldrz2q8gSGzdjkCDjynabf64Vip3RdfO00FhoSURqTiKXU7VzS7JCidBqPlmmQjZWLFKhvYEic00ikfQ40aZcNmTAquat_ubXyhtEZODcTdTjUP9zhqqmEu3lsGrpUNzZSRop1RkW0PW8W05Bs790MkJZZb9Q" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh3.googleusercontent.com/rtR08mszHTEvXAsMbsTe9swxuNkhBFlTbAuKuCkH4K84krfd__HDTBw8QcAT7p85b8t34ohlOXtQsQf39rXuaCRln9UvUN7nzTprau62czyKcfORsdoa9Jcad6qJLmOXD3-MG4wic299E6prhj-nftsIobNHcqQwDZ0odJcjmEp-1h7ApHPZTiWTC9oO0w" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/jDBJKDoXJAsxE_LojB_vWpqacAGHdI3jX3IYtl3EpGw4nFJDmZn_6iINT4mOp2WCyj5Q7rNdVjBwSjeo6r9fw6FrsOvmEbBBa76jVB3ArXoNZ5E-5Dm62I9aqvEfAe34ASeCRn52JVtzuDeR8qDtuz6Vze3ywpeFAUBTfCejsztXO4u1BOrwClAnvzz__w" alt=""><figcaption></figcaption></figure>

### UOM, Rules & Calculations

#### Unit of Measurement

This needs to be configurable, configured with the start of using the product and can not be changed once the product is live and in use.

#### Calculation of Depreciation

It is @1% for every completed year after 10 years up to a maximum of 70%. Up to 10 years of building age depreciation are not provided. For the capital value of land, no depreciation is applicable.

#### Calculation of Capital Value

To calculate the capital value of a building which is not a flat in the apartment, the capital value of the constructed area and land on which the building is constructed are calculated separately and then added up to arrive at the property's capital value. The capital value is calculated floor-wise.

* Capital Value (Vacant Land)  = Area of vacant land \* circle rate defined for vacant land;
* Capital Value (Individual Building) = Land Capital Value + Builtup area of building \* circle rate defined for the building;

The capital value for the apartment is calculated on the super built-up area of the flat. In this case, land capital value is not added to flat capital value.

* Capital Value (Flat In Apartment) = Super built-up area of flat \* circle rate defined for the building;
* Calculation of Property Tax - Property Tax = Capital Value \* Tax Rates;

## Integration Approach

### No Integration

In this approach capital value calculation logic, circle rates and associated masters are maintained in DIGIT itself and any change/ revision in respect of calculation logic, and rates are done at IGRS system, which is manually done in DIGIT.&#x20;

1. Masters are maintained in DIGIT.
2. Circle rates are maintained in DIGIT and get updated when required.
3. Capital value calculation logic is maintained in DIGIT along with depreciation calculation.
4. Any change in rate and calculation logic needs a change in DIGIT in terms of configuration/ customization.

### Capital Rate API Integration

In this approach, circle rates are maintained in the IGRS system. While capital value calculation logic and the masters are maintained DIGIT. The API is called to fetch the circle rates from the IGRS system.

1. Masters are maintained in DIGIT in such a way that values can easily be associated with the master values maintained at the IGRS system.
2. Circle rates are maintained only at the IGRS system and fetched by DIGIT on the fly. It avoids the need to manually maintain the rates in DIGIT.
3. Capital value calculation logic is maintained in DIGIT along with depreciation calculation, hence a change in capital value calculation needs a change in DIGIT.

### Capital Value API Integration

In this approach capital value calculation logic rates are maintained in the IGRS system. While only associated masters are maintained in DIGIT. API is called to fetch the capital value from the IGRS system by passing appropriate values.&#x20;

1. Masters are maintained in DIGIT in such a way that values can easily be associated with the master values maintained at the IGRS system.
2. Circle rates are maintained only at the IGRS system.
3. Capital value calculation logic is also maintained in the IGRS system only.&#x20;
4. DIGIT performs the API call to fetch the capital value from the IGRS system by passing all required data to IGRS.
5. This approach avoids the need to maintain rates and calculation logic in DIGIT. Hence any change in rate and capital value calculation will require a change in DIGIT.

### Use cases  - Capital Value Calculation

Suppose circle rates are defined as given below.

<table><thead><tr><th width="154">Type</th><th width="121">Usage 1</th><th width="139">Construction</th><th width="181">Usage 2</th><th>Rate</th></tr></thead><tbody><tr><td>Individual</td><td>Residential </td><td>Pakka </td><td><br></td><td>12000</td></tr><tr><td>Individual</td><td>Residential </td><td>Kachcha </td><td><br></td><td>10000</td></tr><tr><td>Individual</td><td>Non-residential</td><td><br></td><td>Shop/ Restaurant/ Office</td><td>64000</td></tr><tr><td>Individual</td><td>Non-residential</td><td><br></td><td>Others</td><td>58000</td></tr><tr><td>Flat</td><td><br></td><td><br></td><td><br></td><td>30000</td></tr><tr><td>Plot</td><td><br></td><td><br></td><td><br></td><td>16000</td></tr></tbody></table>

\*\* Rates are defined per Sq. Mt.

### Vacant Land

Suppose there is an open plot with an area of 167 sq. mt. Then the capital value calculated will be.

Capital Value = 167 \* 16000 = 26,72,000;

### Individual Building (Residential)&#x20;

**The age of the building is less than 10 Years.**

* Plot Area = 1000 sq. mt.
* Built-up Area = 800 sq. mt.
* Usage = Pakka

The calculation of capital value will be as illustrated below.

* Capital value for land = 1000 \* 16000 = 1,60,00,000;
* Capital value for construction = 800 \* 12000 = 96,00,000;
* Capital Value of Property = 1,60,00,000 + 96,00,000 = 25,600,000;

**The age of the building is less than 21 Years.**

* Plot Area = 1000 sq. mt.
* Built-up Area = 800 sq. mt.
* Usage = Pakka

The calculation of capital value will be as illustrated below.

* Capital value for land = 1000 \* 16000 = 1,60,00,000;
* Capital value for construction = 800 \* 12000 = 96,00,000;
* Depreciated capital value of construction = 96,00,000 - 96,00,000\*11/100 = 85,44,000;
* Capital Value of Property = 1,60,00,000 + 85,44,400 = 24,544,000;

### Individual Building (Non-residential)

* Plot Area = 1000 sq. mt.
* Built-up Area = 800 sq. mt.
* Usage = Shop/ Restaurant/ Office

The calculation of capital value will be as illustrated below.

* Capital value for land = 1000 \* 16000 = 1,60,00,000;
* Capital value for construction = 800 \* 64000 = 5,12,00,000;
* Capital Value of Property = 1,60,00,000 + 5,12,00,000 = 52,80,03,200;

### Flat In an Apartment

* Super built-up area = 139.355 sq. Mt.
* Capital value = 139.355 \* 30000 = 41,80,650;

## System Studies

### IGRS UTTARAKHAND

### Screenshots

<figure><img src="https://lh5.googleusercontent.com/oVO1hlPc0VqJRQb3AnDlJ_2-4oy0oHKnoASO-X6jhMBn8Vveb8d0S4JPzh9qABufclo-qOlVMGe0mBn7_3av915_YMsTODRDAR4Lwg_F42-fLnVpywlRithfN09JHAAJmAZO9GfKQ4ekCqXM6bXeMvt30VZ1hzon8LX0iQFXAj0rDwFvcI4ZMYkpDfn1bA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh5.googleusercontent.com/cqHvMWUz3BLpUbLuhUo3JwjlPeAwCivyaU0JpqIN5-9bHZSDFM5eUcCBti84JTFhEDhn081fvnYGKffwxDNUGaYa30uBHgEpzxDe9gOOlk3ICVp9Ykz9ZqAauc8wMp4SZetO4Xt6WWS69zzfmgySGw_STpGLv8RgvU7UgosccgxktafFeMTMyCjfKkEkvA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/5B8gbuM9xwLzLb9fW8cp3rh1QsciB92CMG5FM4EHgl9GtExxFf-1DuxtIrevSVcqk82BPFKxD8kVxn8YTDq0rXtc9eAGWxKs6PdB_yLzVfAGlGjHR24a1oq37SZK1lqrl5KwZOrK7BWhLcHPdXGIeecl787oU_BJXzC2CF34XfmMwjeAnEswsxhqYSFhFA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/QMMH7Ejc463wS5jQl0vPHX8d-TYMU82CFCn4pDYaAPQmGMLPX0QScYWfCz9KJp0O3UQHghhGsa-JPE0DMPKSkwX4N17LtkmjJ_j95fjhUrbnvMQH8fNnxv6K6S9LUzWHY6gwOqLN_6Qugv8HYLs0ZchILYI9LK_v7RbUYbTJC_S3r7nqyfgdVeZ5KCLiAQ" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/rE1Znpl6woGBfwwyw1X_WLeQ6b4NcrJ6bzy9S2t63z4RbwmKRTV5Rz7VYHDAC7eLW5bQn26MFETrjLcnlLmOMGfbuYC2dCQoGHcCmOUVNhXfeM8ldeyG6Np55K2NzXJuS3IYJUaF4xMl41vPHMIwLHsRx254oYgTIJjg-1fJj2qYiUUwOFH3IqyjNSqFYg" alt=""><figcaption></figcaption></figure>

### Masters Data Relationship&#x20;

<table><thead><tr><th>Property Type</th><th>Property Type (Hindi)</th><th width="115">Usage</th><th>Nature Of Business</th><th>Construction Type</th><th>Distance From Road</th></tr></thead><tbody><tr><td>Forming Land</td><td>कृषि भूमि</td><td> </td><td> </td><td> </td><td> </td></tr><tr><td><p>Vacant Land</p><p>(Land area In Sq. Mt.)</p></td><td>अकृषि भूमि</td><td>NA</td><td>NA</td><td> </td><td>0 से 50 मीटर तक</td></tr><tr><td>51 से 350 मीटर तक</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>350 मीटर से अधिक</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>0-50 मीटर</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>51 से 200 मीटर तक</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>200 मीटर से अधिक</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>0 से 200 मीटर तक</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td><p>Flat in apartment</p><p>(Super builtup area In Sq. Mt.)</p></td><td>बहुमंजलीय आवासीय भवन में स्थित आवासीय फ्लैट</td><td>Residential</td><td>NA</td><td>NA</td><td>NA</td></tr><tr><td><p>Individual building</p><p>(Builtup area in Sq. Mt.)</p></td><td>वाण्ज्यििक भवन/ गैर वाण्ज्यििक भवन</td><td>Residential</td><td>NA</td><td>प्रथम श्रेणी (लिन्टरपोष)/ (पक्का )</td><td>NA</td></tr><tr><td>द्वितीय श्रेणी (टीनपोश)/ (सेमी पक्का/ कच्चा)</td><td>NA</td><td></td><td></td><td></td><td></td></tr><tr><td>Non-residential</td><td>दुकान/रेस्टेरेन्ट/कार्यालय</td><td>NA</td><td>NA</td><td></td><td></td></tr><tr><td>अन्य वाण्ज्यििक प्रतिष्ठान</td><td>NA</td><td>NA</td><td></td><td></td><td></td></tr></tbody></table>

### Data Elements To Calculate CV

**Boundaries (IGRS Boundary Hierarchy)**

1. District
2. SRO
3. Location Area
4. Village/ Mauza

**Property Level**

1. Property Type
2. Property Sub-type
3. Usage - AP classifies open plots also into residential and non-residential categories.

**Floor Level**

1. Floor Type
2. Sub-usage - Applicable only to commercial properties.
3. Construction Type - It is termed as construction type as well.
4. Construction Year - It is calculated from the date of construction.
5. Area - In some other places it is the built-up area/ super built-up area considered for calculation.

There are 2 masters from IGRS values which covers Property Type, Usage, Sub-usage, and Construction Type. It also consists of the distance of the property from the road which is currently not available in the DIGIT. Hence the option to establish the mapping between IGRS and DIGIT masters is to be provided.

1. Area Major Class
2. Area Class

### IGRS Andhra Pradesh

### Screenshots

<figure><img src="https://lh4.googleusercontent.com/EGr2fDMIYvu_RxRFf91XiTs958iu9aGRIVZ_estxiwo5IB7z97tNX0yL5SSAeQmA0tyZvRQGbPPqr34sgTZZ44Or6bjGZ_okOrBFvDNhpZXiEibyCXv8cXpxChJ8Addq_s1BQaeFw2I8tIi4zWshDuFh4r9Sz04FTmFu796NLnzZ7G_rcop69cuWeTzdUg" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/3Wt7UCdN379ohRelM29AZnYwpc8iMOMM1s-u2Lf047Da2xg4Hhsy-VdjckfBLf4I7wridZAZLtVoBjPTAo-MEClkNGxdenIi3rwc9puEdr535eFjKJd489YT-nms4GnPSmDqXpC1GWjKfEoFExoySZAPMVQN8MuzoTc_2wznbK8hPh0_xSsw6hmaF55fmg" alt=""><figcaption></figcaption></figure>

### Master Data Relationship

| Property Type       | Usage (Applicable all other than Forming Land) | Construction Type (Applicable to all irrespective of residential or non-residential) |
| ------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------ |
| Forming Land        |                                                |                                                                                      |
| Vacant Land         | Residential                                    | RCC                                                                                  |
| Non-residential     | Mud Roof                                       |                                                                                      |
| Flat in apartment   | Residential                                    | Roof with palm/grass etc. with brick wall                                            |
| Non-residential     | Roof with palm/grass etc. without brick wall   |                                                                                      |
| Individual building | Residential                                    | ACC/M. T/ Pan Tile/ Shabad Stone/Zn Sheet                                            |
| Non-residential     | ACC/TIN/Zn Sheet etc. with walls above 10 ft.  |                                                                                      |
| <p><br></p>         | <p><br></p>                                    | Poultry Form                                                                         |
| <p><br></p>         | <p><br></p>                                    | Apartment without common walls at least 3 sides                                      |

### Data Elements To Calculate CV

Boundaries (IGRS Boundary Hierarchy)

1. District
2. SRO
3. Village
4. Habitation/Locality
5. Ward
6. Block
7. Door No.

Property Level

1. Property Type
2. Property Sub-type
3. Usage - AP classifies open plots also into residential and non-residential categories.

Floor Level

1. Floor No.
2. Structure Type - It is termed a construction type as well.
3. Plinth Area - In some other places it is the built-up area/ super built-up area considered for calculation.
4. Stage of construction -  ULBs assess the completed properties only. Under-construction properties are considered for property tax assessment.
5. Age of building - It is calculated from the date of construction.

## Open Questions

* [x] Is it possible to categorize the SROs into URBAN and RURAL? As we are interested in urban areas only.

**UKD:** SROs follow different hierarchies - decided based on tehsil boundary. cannot be categorised as purely urban or rural, can be mixed

**AP:** SROs have their own jurisdiction which is independent of the ULB.  Typically SRO has Urban and Rural areas under its jurisdiction.  Some ULBs have more than one SRO.  In AP, NIC is the solution provider for IGRS.  NIC has shared the Capital Rates data with CDMA.  ULBs are asked to share the SRO Codes which fall under their jurisdiction.  So, relevant data is pushed to the respective masters of the ULB.  Provision was enabled to disable those Areas which doesn't fall under the ULB.

* [x] To calculate the capital value, is it necessary to have the deed type and deed sub-type or these are needed only to calculate stamp duty?

**UKD:** yes, these details are required.

**AP:**  To calculate Capital Value, Deed Type and Sub-type is not required.  Provision is enabled to capture Deep Type at the time of applying for New Assessment and Title Transfer.

* [x] What are the cases where the distance of the property from the road is needed?

**UKD:** in all cases, the circle rate is calculated based on this

**AP:** This is not a criterion in AP - might be specific to UKD.&#x20;

* [x] Is it necessary to capture the property detail floor-wise to calculate the capital value? If not, then what is the role of the floor in capital value calculation?

**UKD:** since earlier, they have floor-based calculation, recommended to keep floor details even though it is not being used in CV calculation. also for subsequently constructed floors, the cost of construction will be different

**AP:** Yes – floor details need to be captured as:

1. depreciation is given based on the year of construction.  There might be cases where all floors are not constructed at the same time.
2. usage \[Residence/ Non-Residence] might be different for each floor.

* [x] In capital value calculation, what is the role of the land area on which a building is constructed?

**UKD:** land area does not impact CV

**AP:** Capital Value is calculated in 2 different ways for buildings:&#x20;

1. For Apartments, Floorwise Composite Rate is defined for the specific Door No. is considered.  In this case, Land Value is not considered.
2. For Non-Apartment, Structure Value based on the type of construction is considered for the calculation of Structure Capital Value \[SCV].  The piece of Land that is used to construct the Structure is used to calculate Land Capital Value \[LCV].  SCV + LCV is the total Capital Value of the Property.

* [x] Are the capital value of land and the building both calculated and then summed up to arrive at the capital value of the built-up structure?

**UKD:** yes land and building CV are calculated separately and then added.

**AP:** Yes – Land Value and Structure Value are calculated separately and summed up for Non-Apartments.

* [x] What is the Village/ Mauza and how is it different from the Area of land?

**UKD:** this is based on tehsil revenue records/maps. not used for the calculation of CV but important in MIS

**AP:**  Not familiar with this terminology – might be specific to UKD.

* [x] What is the role of the construction year in capital value calculation?

**UKD:** this is considered in calculating depreciation

**AP:** Construction Date is required to calculate Depreciation.&#x20;

* [x] What type of rebate is provided, is it applicable to the calculation of capital value or stamp duty or both?

**UKD:** not decided yet but needs to be kept configurable. early payment + one configurable (based on ULB) are recommended heads.

**AP:**  There is no rebate given at the time of calculation of Capital Value.

* [x] What is the role of the age of the building in capital value calculation?

**UKD:** based on the year of construction. recommended keeping the year of construction rather than this

**AP:**  Age is dependent on the Date of Construction of the floor which is required for the calculation of Depreciation.&#x20;

* [x] It looks like Distance from road values is not common across the ULBs. Are the SROs following different values? Please see the table below for more details.

**UKD:** this will be decided by the Revenue Dept / SRO. ULBs will not have a say also, this needs to be maintained as part of the master data setup.

**AP:** This might be specific to UKD.

### IGRS - Boundaries (Uttarakhand)

### **Districts**

| dcode           | dname        | dname\_eng        | census\_code | distict\_order |
| --------------- | ------------ | ----------------- | ------------ | -------------- |
| DISTRICT MASTER |              |                   |              |                |
| 01              | अल्मोडा      | ALMORA            | 64           | 10             |
| 02              | बागेश्वर     | BAGESWAR          | 63           | 11             |
| 03              | चम्पावत      | CHAMPAWAT         | 65           | 13             |
| 04              | देहरादून     | DEHRADUN          | 60           | 1              |
| 05              | पौडी गढ़वाल  | PAURI GARHWAL     | 61           | 5              |
| 06              | चमोली        | CHAMOLI           | 57           | 8              |
| 07              | हरिद्वार     | HARIDWAR          | 68           | 2              |
| 08              | नैनीताल      | NAINITAL          | 66           | 4              |
| 09              | टिहरी गढ़वाल | TEHRI GARHWAL     | 59           | 6              |
| 10              | पिथौरागढ़    | PITHORAGARH       | 62           | 12             |
| 11              | रुद्रप्रयाग  | RUDRAPRAYAG       | 58           | 9              |
| 12              | उधम सिंह नगर | UDHAM SINGH NAGAR | 67           | 3              |
| 13              | उत्तरकाशी    | UTTARKASHI        | 56           | 7              |

### Sub-registrar Office (SRO)

| dcode                       | srocode | sroname                                   | sroname\_eng                 |
| --------------------------- | ------- | ----------------------------------------- | ---------------------------- |
| Sub Registrar Office Master |         |                                           |                              |
| 01                          | 01      | अल्मोडा                                   | ALMORA                       |
| 01                          | 02      | भिकियासैण                                 | BHIKIYASEN                   |
| 01                          | 03      | रानीखेत                                   | RANIKHET                     |
| 02                          | 01      | बागेश्वर                                  | BAGESWAR                     |
| 02                          | 02      | कपकोट                                     | KAPKOT                       |
| 03                          | 00      | कैम्प कार्यालय टनकपुर ,चम्पावत            | CHWAT                        |
| 03                          | 01      | चम्पावत                                   | CHAMPAWAT                    |
| 04                          | 00      | डिस्ट्रिक्ट रजिस्ट्रार, देहारादून         | DISTRICT REGISTRAR, DEHRADUN |
| 04                          | 01      | देहरादून,प्रथम                            | DEHRADUN-I                   |
| 04                          | 02      | देहरादून,द्वितीय                          | DEHRADUN-II                  |
| 04                          | 03      | देहरादून,तृतीय                            | DEHRADUN-III                 |
| 04                          | 04      | देहरादून,चतु्र्थ                          | DEHRADUN-IV                  |
| 04                          | 05      | ऋषिकेश                                    | RISHIKESH                    |
| 04                          | 06      | विकासनगर ,प्रथम                           | VIKASNAGAR-I                 |
| 04                          | 07      | विकासनगर द्वितीय                          | VIKASNAGAR-II                |
| 04                          | 08      | चकराता                                    | CHAKRATA                     |
| 04                          | 09      | मसूरी कैम्प कार्यालय                      | MUSSOORIE                    |
| 04                          | 10      | त्यणी                                     | TYUNI                        |
| 04                          | 11      | कालसी                                     | KALSI                        |
| 04                          | 12      | देहरादून तृतीय 1995-1999                  | DEHRADUN-III 1995-1999       |
| 04                          | 51      | देहरादून                                  | Dehradun                     |
| 04                          | 52      | विकासनगर                                  | Vikasnagar                   |
| 05                          | 00      | कैम्प कार्यालय यमकेश्वर, कोटद्वार         | KOTDWAR                      |
| 05                          | 01      | कोटद्वार                                  | KOTDWAR                      |
| 05                          | 02      | लेन्सडौन                                  | LANSDOWNE                    |
| 05                          | 03      | पौड़ी                                     | PAURI                        |
| 05                          | 04      | श्रीनगर                                   | SRINAGAR                     |
| 06                          | 01      | चमोली                                     | CHAMOLI                      |
| 06                          | 02      | जोशीमठ                                    | JOSHIMATH                    |
| 06                          | 03      | कर्णप्रयाग                                | KARNPRAYAG                   |
| 06                          | 04      | थराली                                     | THARALI                      |
| 07                          | 01      | हरिद्वार,प्रथम                            | HARIDWAR-I                   |
| 07                          | 02      | हरिद्वार,द्वितीय                          | HARIDWAR-II                  |
| 07                          | 03      | लकसर                                      | LAKSAR                       |
| 07                          | 04      | रुड़की,प्रथम                              | ROORKEE-I                    |
| 07                          | 05      | रुड़की,द्वितीय                            | ROORKEE-II                   |
| 07                          | 06      | रुड़की,तृतीय                              | ROORKEE-III                  |
| 07                          | 51      | हरिद्वार                                  | Haridwar                     |
| 07                          | 52      | रुड़की                                    | Roorkee                      |
| 08                          | 00      | कैम्प कार्यालय कालाढूंगी ,                | हल्द्वानी,द्वितीय            |
| 08                          | 01      | कैम्प कार्यालय कालाढूंगी ,हल्द्वानी,प्रथम | HALDWANI-I                   |
| 08                          | 02      | हल्द्वानी,द्वितीय                         | HALDWANI-II                  |
| 08                          | 03      | नैनीताल                                   | NAINITAL                     |
| 08                          | 04      | रामनगर                                    | RAMNAGAR                     |
| 08                          | 05      | धारी                                      | DHARI                        |
| 08                          | 51      | हल्द्वानी                                 | Haldwani                     |
| 09                          | 01      | देवप्रयाग                                 | DEVPRAYAG                    |
| 09                          | 02      | घनसाली                                    | GHANSALI                     |
| 09                          | 03      | जाखणीधार                                  | JAKHNIDHAR                   |
| 09                          | 04      | टिहरी                                     | TEHRI                        |
| 10                          | 01      | डीडीहाट                                   | DIDIHAT                      |
| 10                          | 02      | गंगोलीहाट                                 | GANGOLIHAT                   |
| 10                          | 03      | पिथौरागढ़                                 | PITHORAGARH                  |
| 11                          | 01      | रुद्रप्रयाग                               | RUDRAPRAYAG                  |
| 11                          | 02      | ऊखीमठ                                     | UKHIMATH                     |
| 12                          | 01      | बाजपुर                                    | BAZPUR                       |
| 12                          | 02      | जसपुर                                     | JASPUR                       |
| 12                          | 03      | काशीपुर                                   | KASHIPUR                     |
| 12                          | 04      | किच्छा                                    | KICHHA                       |
| 12                          | 05      | सितारगंज                                  | SITARGANJ                    |
| 12                          | 06      | रुद्रपुर                                  | RUDRAPUR                     |
| 13                          | 01      | बड़कोट                                    | BARKOT                       |
| 13                          | 02      | पुरोला                                    | PUROLA                       |
| 13                          | 03      | उत्तरकाशी                                 | UTTARKASHI                   |

### Blocks

<table><thead><tr><th width="115">dcode</th><th width="119">srocode</th><th width="135">circle_rate_id</th><th width="123">Block Code</th><th>Block Name</th></tr></thead><tbody><tr><td>Segment Master</td><td></td><td></td><td></td><td></td></tr><tr><td>4</td><td>1</td><td>5</td><td>3070</td><td>रायपुर मार्ग पर काली  मन्दिर से नालापानी चौक होते हुये सहस्त्रधारा मार्ग तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3071</td><td>डोईवाला - बुल्लावाला मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3072</td><td>डोईवाला - खत्ता मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3073</td><td>डोईवाला - धर्मूचक मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3074</td><td>मियॉवाला नहर वाली सड़क से रायपुर राझांवाला तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3075</td><td>नकरौन्दा-घिसर पडी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3076</td><td>गूलरघाटी रायपुर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3077</td><td>मुख्य हिरद्वार मार्ग मियॉवाला चौक से चकतुनाला होते हये हाथीखाना चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3078</td><td>मुख्य हरिद्वार मार्ग से माजरी माफी (रेलवे फाटक), हरिपुर/नवादा होते हुए इन्दरपुर तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3079</td><td>जोगीवाला चौक से बद्रीपुर होते हुए इन्दरपुर तक, बद्रीपुर चौक से माजरी माफी तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3080</td><td>विधान सभा के बाद स्थित रेलवे फाटक के बाद से एम0डी0डी0ए0 कालोनी केदारपुरम तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3081</td><td>हरिद्वार रोड पर कुऑवाला से गूलरघाटी चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3082</td><td>फयरिंग रेंज के बाद से दौडवाला होते हुये दुधली डोईवाला मार्ग तक, केदारपुर सचिवालय कालोनी के बाद से दुधली डोईवाला मार्ग तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3083</td><td>दून यूनिवर्सिटी से मोथरोवाला लिंक रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3084</td><td>सहारनपुर हरिद्वार बाईपास मार्द से दक्षिण दिशा की ओर जाने वाली मोथरोवाला मार्ग से दून यूनिवर्सिटी के सामने से केदारपुर / सचिवालय कालोनी होकर जाने वाला मार्ग जो अन्त में फाईरिंग रैज के पुल पर मिल जाता है ।</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3085</td><td>सहारनपुर हरिद्वार बाईपास मार्ग पर पुलिस चैक पोस्ट के सामने, महिन्द्रा शोरूम के बाराबर से मोथरोवाला रोड बंगाली कोठी के बाद ,केदारपुर, प्राथमिक पाठशाला होते हुए दुधली-डोईवाला मार्ग के पुल तक,</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3086</td><td>सहारनपुर हरिद्वार बाईपास मार्द से दक्षिण दिशा की ओर जाने वाली कारगी / कारगी चौक से बंजारावाला तक,</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3087</td><td>मौथरोवाला दूधली डोईवाला मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3088</td><td>चकराता रोड आई0एम0ए0 के सामने से प्रेमनगर-गोरखपुर रोड ग्राम आरकेडियाग्रान्ट की सीमा तक तथा तेलपुरा चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3089</td><td>डाईवर्जन रोड से सिनौला-जोहडी-अनारवाला वाला मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3090</td><td>जाखन-जोहडी मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3091</td><td>रिखोली-मसूरी  बाईपास रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3092</td><td>कुठाल गेट से मसूरी तक मुख्य मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3093</td><td>पुराना पोस्ट आफिस (जोगीवाला) से किद्दूवाला चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3094</td><td>पुलिया नं0 6 से किद्दूवाला चौक होते हुये महाराणा प्रताप चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3095</td><td>मसूरी बाईपास रोड-रिंग रोड (पुलिया नं0 6 के बाद से रायपुर रोड तक )</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3096</td><td>मालसी पुलिया से दोनाली चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3097</td><td>रायपुर चौक (शिव मन्दिर) से मालदेवता मार्ग वाया वाण्डा वाली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3098</td><td>किरसाली चौक से काला गॉव तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3099</td><td>सहस्त्रधारा रोड ( कुल्हान करनपुर के बाद से मालदेवता तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3100</td><td>मालदेवता सिल्ला क्यारा रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3101</td><td>रायपुर रोड पर चक्की नम्बर चार से दोनाली चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6285</td><td>रायपुर - थानो मार्ग (रायपुर चौक से थानो चौक तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3102</td><td>सहस्त्रधारा मार्ग पर स्थित किरसाली चौक से मसूरी बाई पास मार्ग पड़नेवाले समस्त राजस्व ग्राम एवं उक्त मार्ग के अन्त में स्थित साई मन्दिर के बराबर पर पहॅुचने वाले मार्ग तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3103</td><td>गुनियाल गांव-भगवतपुर मार्ग पुरूकुल गॉव तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3104</td><td>हरिद्वार रोड पर लच्छीवाला फलाईओवर के बाद से डोईवाला टाउन एरिया क्षेत्र के प्रारम्भ होने तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3105</td><td>शिमला बाईपास राड पर मेहुवाला ग्राम के बाद से ग्राम बडोवाल की सीमा समाप्ति तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3106</td><td>सहारनपुर रोड पर चन्द्रबनी चौक से वाईल्ड लाईफ संस्थान तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3107</td><td>सहारनपुर रोड से ब्राहमणवाला रोड माजरा क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3108</td><td>सहारनपुर रोड से इन्द्रा गाधी मार्ग माजरा क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3109</td><td>सहस्त्रधारा रोड पर छतरी के बाद से सहस्त्रधारा तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3110</td><td>रायपुर रोड से काली मन्दिर से रायपुर तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3111</td><td>रायपुर रोड पर सहस्त्रधारा  चौक से काली मंदिर तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3112</td><td>सहस्त्रधारा मार्ग पर स्थित आई0टी0 पार्क वाले मार्ग पर पड़नेवाले समस्त राजस्व ग्राम एवं उक्त मार्ग के अन्त में स्थित उप्पल टावर से होते हुये कैनाल रोड से पूर्व तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3113</td><td>सहस्त्रधारा रोड पर आई0 टी0 पार्क के आगे से छतरी तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3114</td><td>मसूरी बाईपास रोड-रिंग रोड (जोगीवाला चौक से पोस्ट आफिस होते हुये पुलिया नं0 6 तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3115</td><td>लक्ष्मी रोड के चौराहे से बद्रीश कालोनी होते हुए पुलिया नं0 6 तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3116</td><td>मोथरोवाला रोड (धर्मपुर चौक के निकट से बाईपास रोड तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3117</td><td>माता मन्दिर रोड (धर्मपुर चौक से बाईपास रोड पर स्थित पुलिस चौक पोस्ट तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3118</td><td>हरिद्वार रोड पर कुऑवाला से लच्छीवाला फ्लाई ओवर तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3119</td><td>कौलागढ रोड पर सैन्ट्रल स्कूल से आगे कौलागढ की सीमा तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3120</td><td>चकराता रोड पर प्रेननगर बस स्टैन्ड से नदी तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3121</td><td>बाईपास रोड (सहारनपुररोड से हरिद्वार रोड तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3122</td><td>शिमला बाईपास रोड पर सहारनपुर रोड के 350 मीटर बाद से मेहुवाला ग्राम की सीमा समाप्ति तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3123</td><td>सहारनपुर रोड पर सुभाष नगर चौक से आगे वन क्षेत्र तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3124</td><td>सहारनपुर रोड लाल पुल से महन्त इन्द्रेश अस्पताल- देहराखास होते हुये कारगी चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3125</td><td>सर्वे चौक से रायपुर रोड पर रिस्पना पुल, सहस्त्रधारा चौक होते हुये आई0टी0पार्क तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3126</td><td>हरिद्वार रोड पर जोगीवाला से कुँवावाला तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3127</td><td>सहारनपुर रोड पर टर्नर रोड से सुभाष नगर चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3128</td><td>एफ आर आई के सामने से बसन्त विहार चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3129</td><td>अनुराग नर्सरी रोड पर बल्लीवाला चौक से बसन्त विहार चौक- लवली मार्किट- पंडितवाडी चकराता रोड तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3130</td><td>अनुराग नर्सरी से इन्द्रानगर- सीमाद्वार- जी0एम0एस0 रोड तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3131</td><td>कांवली रोड/शिवाजी मार्ग पर सहारनपुर चौक से बल्लीवाला चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3132</td><td>मौरवियन इन्स्टीटयूट वाली ओल्ड मसूरी रोड पर राजपुर तिराहे से कुठालगेट तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3133</td><td>शहंशाही आश्रम वाली ओल्ड मसूरी रोड पर राजपुर तिराहे से कुठालगेट तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3134</td><td>जी0एम0एस0 रोड (बल्लीवाला चौक से सेवला कलां ट्रान्सपोर्ट नगर होते हुए मौहब्बेवाला, सहारनपुर रोड तक) तथा सकलानी गैस गोदाम क्रासिंग से सहारनपुर रोड पर सब्जी मण्डी तिराहे तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3135</td><td>सहारनपुर रोड पर बिन्दाल पुल से टर्नर रोड तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3136</td><td>गढी चौक से बल्लुपुर चौक वाली- कैनाल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3137</td><td>चकराता रोड पर बल्लुपुर चौक से प्रेमनगर बस स्टैण्ड तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3138</td><td>हरिद्वार रोड रिस्पना पुल से जोगीवाला तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3139</td><td>जी0एम0एस0 रोड (बल्लुपुर चौक से बल्लीवाला चौक तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3140</td><td>कौलागढ़ रोड पर किशन नगर चौक से सैन्ट्रल स्कूल तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3141</td><td>सहारनपुर रोड पर सहारनपुर चौक से बिन्दाल पुल तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3142</td><td>डायवर्जन रोड पर मालसी डीयर पार्क से कुठाल गेट तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3143</td><td>डायवर्जन रोड पर मसूरी बाईपास से मालसी डीयर पार्क तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3144</td><td>राजपुर रोड के समानान्तर कैनाल रोड काठबंगला तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3145</td><td>राजपुर रोड पर मसूरी बाईपास से राजपुर तक (साई मन्दिर होते हुए)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3146</td><td>सुभाष रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3147</td><td>ईस्ट कैनाल राड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3148</td><td>न्यू कैन्ट रोड (कैंट सीमा तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3149</td><td>हरिद्वार रोड प्रिन्स चौक से रिस्पना पुल तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3150</td><td>चकराता रोड पर घंटाघर से बिन्दाल पुल-किशन नगर चौक होते हुये बल्लुपुर चौराहे तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3151</td><td>गांधी रोड पर रेलवे स्टेशन से आढत बाजार होते हुये सहारनपुर चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3152</td><td>सहारनपुर रोड पर रेलवे स्टेशन से सहारनपुर चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3153</td><td>घंटाघर से लक्खीबाग चौकी तक के मध्य स्थित पल्टन बाजार/धामावाला/पीपल मण्डी/दर्शनी गेट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3154</td><td>गांधी रोड पर घंटाघर से दर्शन लाल चौक/ प्रिन्स चौक होते हुये रेलवे सटशन तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3155</td><td>राजपुर रोड पर आर0टी0ओ0  कार्यालय से मसूरी बाईपास तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3157</td><td>राजपुर रोड पर घण्टाघर से आर0टी0ओ0  कार्यालय तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3218</td><td>अजबपुर कलां</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3420</td><td>बिन्दाल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3421</td><td>खदरी मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3422</td><td>छबील बाग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3423</td><td>जटिया मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3424</td><td>इन्द्रश नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3425</td><td>प्रेमनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3426</td><td>कांवली शेष क्षेत्र (कांवली क्षेत्र की उल्लिखित कालोनी / मौहल्लों को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3427</td><td>चक सेवलाखर्द</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3428</td><td>कारगी ग्राण्ट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3429</td><td>निरंजनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3430</td><td>ब्राहमणवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3431</td><td>सत्यान मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3432</td><td>पुराना राजपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3433</td><td>राजपुर माफी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3434</td><td>प्रेमपुर माफी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3435</td><td>लोहारवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3436</td><td>गोपीवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3437</td><td>धरतावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3438</td><td>डुगालगांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3439</td><td>थानीगांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3440</td><td>गढी कैन्ट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3441</td><td>कौलागढ मय चक भूड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3442</td><td>चक शाहनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3443</td><td>शाहनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3444</td><td>शाहपुर सन्तौर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3445</td><td>इन्दरपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3446</td><td>केदारपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3447</td><td>चक डालनवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3448</td><td>धर्मपुर डांडा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3449</td><td>डिफेन्स कालोनी, शाहनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3450</td><td>एम0डी0डी0ए0 कालोनी अजबपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3451</td><td>एम0डी0डी0ए0 कालोनी केदारपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3452</td><td>अजबपुर चक-2 (चक अजबपुरकला)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3453</td><td>अजबपुर चक- 1 (चक अजबपुरकला)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3454</td><td>अजबपुर खुर्द</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3455</td><td>ब्रहमावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3456</td><td>चिडोवाली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3457</td><td>धोरण खास</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3458</td><td>कण्डोली (केन्द्रीयदून)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3459</td><td>हथड़ीगांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3460</td><td>रांघडवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3461</td><td>बाजावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3462</td><td>माजरा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3464</td><td>धर्मपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3465</td><td>पंडितवाडी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3466</td><td>अजीत प्रसाद मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3467</td><td>आनन्द चौक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3468</td><td>रामेश्वर मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3469</td><td>अखाडा मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3470</td><td>मुस्लिम कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3471</td><td>खुडबुडा समस्त ब्लांक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3472</td><td>गुजराती मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3473</td><td>डांडीपुर मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3474</td><td>मन्नूगंज</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3475</td><td>हकीकतराय नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3476</td><td>नेताजी मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3477</td><td>मालियाना मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3478</td><td>लक्खीबाग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3479</td><td>रामनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3480</td><td>सिंगल मण्डी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3481</td><td>रीठा मण्डी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3482</td><td>पथरीबाग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3483</td><td>भण्डारी बाग समस्त ब्लांक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3484</td><td>ट्रान्सपोर्ट नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3485</td><td>बाडीगार्ड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3486</td><td>टीचर्स कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3487</td><td>कुम्हारमण्डी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3488</td><td>गोविन्दगढ</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3489</td><td>कौलागढ मय चक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3491</td><td>सैय्यद मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3492</td><td>हाथीबडकला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3493</td><td>विजय कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3494</td><td>चक सालावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3495</td><td>सालावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3496</td><td>पथरियापीर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3497</td><td>अहीर मण्डी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3498</td><td>परसोलीवाला मय चक नरसिह वाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3499</td><td>डोभालवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3500</td><td>बकराल वाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3501</td><td>डंगवाल मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3502</td><td>ओंकार रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3503</td><td>मित्रलोक कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3504</td><td>चुक्खुवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3505</td><td>चुक्खुवाला नई बस्ती</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3506</td><td>इन्द्रा कालोनी चुक्खुवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3507</td><td>गढ़ी उद्दीवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3508</td><td>गढ़ी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3509</td><td>आराघर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3510</td><td>शास्त्रीनगर (समस्त लेन)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3511</td><td>नेहरू कालोनी (क्रमांक 4-D-15 में वर्णित क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3512</td><td>वीरगिरवाली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3513</td><td>घास मण्डी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3514</td><td>द्वारिका पुरी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3515</td><td>शक्ति एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3516</td><td>व्योमप्रस्थ एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3517</td><td>अलकनन्दा एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3518</td><td>मिलन विहार/ एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3519</td><td>काली मंदिर एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3520</td><td>पुष्पांजली एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3521</td><td>मेघा एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3522</td><td>नर्मदा एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3523</td><td>अंकित पुरम एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3524</td><td>संगम विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3525</td><td>नेहरूपुरम एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3526</td><td>विवेक विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3527</td><td>दुर्गा विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3528</td><td>कालिन्दी एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3529</td><td>उत्सव विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3530</td><td>वन विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3531</td><td>महारानी बाग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3532</td><td>हिल व्यू कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3533</td><td>दत्ता इन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3534</td><td>इंजीनियर्स इन्कलेव (समस्त फेज कॅावली क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3535</td><td>आशीर्वाद इन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3536</td><td>मोहित नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3537</td><td>बसंत विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3538</td><td>इन्दिरा नगर कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3539</td><td>कलालोवाली गली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3659</td><td>लूनिया मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3661</td><td>नेहरू नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3662</td><td>गांधी ग्राम</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3667</td><td>देहराखास</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3668</td><td>लक्ष्मण चौक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3670</td><td>वेस्ट पटेल नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3671</td><td>ईस्ट पटेल नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3672</td><td>गुरू रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3673</td><td>सरस्वती सोनी मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3674</td><td>केशव रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3675</td><td>पार्क रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3676</td><td>विचारनन्द मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3677</td><td>पी0डी0 टंडन रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3678</td><td>नैशनल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3679</td><td>मालवीय रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3680</td><td>महन्त रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3681</td><td>केशव विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3682</td><td>काली मंदिर एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3683</td><td>शाम्भबी लोक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3684</td><td>वसंत विहार एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3685</td><td>साई लोक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3686</td><td>अशोक विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3688</td><td>जनकपुरी एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3689</td><td>गढवाल कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3691</td><td>शिवालिकपुरम</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3692</td><td>प्रियदर्शनी एन्कलेव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3694</td><td>ओल्ड सहस्त्रधारा रोड (अरविन्द मार्ग)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3695</td><td>मानसिंहवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3696</td><td>ओल्ड डालनवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3697</td><td>करनपुर बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3698</td><td>आर्य नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3699</td><td>किशनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3700</td><td>ढाकपट्टी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3701</td><td>जाखन</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3702</td><td>राजपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3703</td><td>प्रतीतपुर संतौर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3704</td><td>आकाशदीप कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3705</td><td>विजयपार्क एक्सटेशन</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3706</td><td>विजयपार्क</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3707</td><td>यमुना कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3708</td><td>ईदगाह</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3709</td><td>प्रकाश नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3710</td><td>राम विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3711</td><td>महेंद्र विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3712</td><td>आनन्द विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3713</td><td>नरेन्द्र विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3714</td><td>दीप लोक कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3715</td><td>चायबाग कौलागढ</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3717</td><td>कौलागढ</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3718</td><td>बल्लुपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3721</td><td>किशन नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3722</td><td>राजेन्द्र नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3723</td><td>एम0डी0डी0ए0 कालोनी चन्दर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3725</td><td>डिफेन्स कालोनी चक शाहनगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3729</td><td>उषा कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3731</td><td>अमन विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3732</td><td>गंगोत्री विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3733</td><td>सुमन विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3735</td><td>मन्दाकिनी विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3736</td><td>गोविन्द नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3737</td><td>मयूर विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3741</td><td>करनपुर खास (सहस्त्रधारा मार्ग पर स्थित )</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3743</td><td>केवल विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3744</td><td>नालापानी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3745</td><td>नदी रिस्पना</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3747</td><td>अधोईवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3748</td><td>बिष्णु रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3749</td><td>सेवक आश्रम रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3750</td><td>डी0एल0 रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3751</td><td>बंगाली लाईब्रेरी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3753</td><td>करनपुर मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3754</td><td>प्रिन्सिपल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3755</td><td>नेगी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3756</td><td>सीमेंट रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3757</td><td>डी0ए0वी0 कालेज रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3758</td><td>बंगाली मौहल्ला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3760</td><td>एम0डी0डी0ए0 कालोनी, सहस्त्रधारा रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3761</td><td>उप्पल टावर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3764</td><td>राजेश्वर नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3766</td><td>नैशविला रोड पर काम्बोज स्वीट शॅाप से छोटी बिन्दाल नदी तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3767</td><td>राजपुर रोड, करनपुरखास, एंव खेडा मानसिहवाला का वह क्षेत्र जो कि राजपुर रोड से 350 माटर दूरी के बाद स्थित है (अर्थात क्रमांक 1-A-में वणिर्त क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3768</td><td>एम0डी0डी0ए0 कालोनी लोहियापुरम</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3769</td><td>सन्त विनोबा भावे मार्ग (अम्बर पैलेस से बाद)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3770</td><td>सन्त विनोबा भावे मार्ग (अम्बर पैलेस से पूर्व)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3771</td><td>त्यागी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3772</td><td>चन्दर नगर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3773</td><td>सिक्का ग्रीन</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3774</td><td>रिवर वैली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3775</td><td>ओर्किड / ओर्चिड पार्क</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3776</td><td>विहस्प्रिंग विलोज</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3777</td><td>पैसिफिक गोल्फ इस्टेट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3778</td><td>पनाष वैली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4253</td><td>रैस्ट कैम्प</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6286</td><td>शिव लोक कॉलोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6287</td><td>बद्रीश कॉलोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3780</td><td>धर्मपुर सब्जी मण्डी चौराहे से लक्ष्मी रोड के चौराहे तक सड़क से 100 माटर दूरी तक (नेहरू कालोनी क्षेत्र की ओर पड़ने वाला क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3781</td><td>हरिद्वार रोड पर रिस्पना पुल तिराहे से विधान सभा होते हुये रेलवे फाटक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3782</td><td>पो0ओ0 रोड (सुभाष नगर क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3783</td><td>टर्नर रोड (क्लेमेनटाउन क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3784</td><td>कृष्णा विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3785</td><td>आनन्द विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3786</td><td>इंजीनियर्स इन्कलेव जाखन क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3787</td><td>दून विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3788</td><td>अंसल ग्रीन वैली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3789</td><td>भागीरथीपुरम - जाखन क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3790</td><td>दिलाराम बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3791</td><td>ओल्ड सर्वे रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3792</td><td>विदेश संचार कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3793</td><td>आयकर कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3794</td><td>नेहरू कालोनी (सी0 ब्लांक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3795</td><td>इन्द्रा मार्केट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3796</td><td>कचहरी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3797</td><td>नरदेव शास्त्री मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3798</td><td>पंत रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3799</td><td>कॅान्वेन्ट रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3800</td><td>न्यू रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3801</td><td>पटेल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3802</td><td>अंसारी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3803</td><td>तिलक रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3805</td><td>इनद्रापुरम</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3806</td><td>चन्द्रलोक कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3807</td><td>साकेत कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3808</td><td>इन्द्रबाबा मार्ग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3809</td><td>कश्मीरी कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3810</td><td>कोचर कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3811</td><td>जज कालोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3812</td><td>डिक रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3813</td><td>उग्र रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3814</td><td>नेमी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3815</td><td>चन्दर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3816</td><td>लक्ष्मी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3817</td><td>कर्जन रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3818</td><td>नेहरू रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3819</td><td>सकुर्लर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3820</td><td>तेग बहादुर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3821</td><td>बलवीर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3822</td><td>मोहिनी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3823</td><td>प्रीतम रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3824</td><td>इन्दर रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3825</td><td>म्यूनिस्पिल रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3826</td><td>रेसकोर्स</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3827</td><td>डालनवाला क्षेत्र में पड़नें वाले समस्त सड़के तथा मौजा धर्मपुर के अग्रवाल बेकर्स- सब्जी मण्डी से पुलियां नं0- 6  तक की सड़क के उत्तर पूर्व का डालनवाला में पड़ने वाला समस्त क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3828</td><td>कालीदास रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3829</td><td>न्यू कैन्ट रोड पर कैन्ट सीमा से आगे गढी डाकरा बाजार तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3830</td><td>नैशविला रोड पर राजपुर रोड से काम्बोज स्वीट शॉप तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3831</td><td>चकराता रोड पर चुक्खुवाला मार्ग,  नारी शिल्प मन्दिर मार्ग,  रामपुर मण्डी रोड (क्रमांक-8-एच-1 में वर्णित क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3832</td><td>लक्ष्मी पार्क जैन कासोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3833</td><td>व्हिस्पिरिंग विलोज</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3834</td><td>शिवम विहार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3835</td><td>शिप्रा कॉलोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3836</td><td>फ्रेंड्स कॉलोनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3837</td><td>प्लेजंट वैली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3838</td><td>एकता कॉलोनी (अकेटा एवेन्यू)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3839</td><td>एकता कॉलोनी (अकेटा एवेन्यू)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3840</td><td>रामलीला बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3841</td><td>घोसी गली</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3842</td><td>बाबूगंज</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3843</td><td>झण्डा मौहल्ला/बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3844</td><td>हनुमान चौक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3845</td><td>मोती बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3846</td><td>सरनीमल बाजार</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3847</td><td>डिस्पेन्सरी रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3848</td><td>अजमल खॉ रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3849</td><td>राजा रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3850</td><td>दर्शनी गेट/आढ़त बाजार (क्रमांक-8-एच -4/5 में वर्णित क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3851</td><td>पीपल मण्डी (क्रमांक-8-एच -4 में वर्णित क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3852</td><td>धामावाला (क्रमांक-8-एच -4 में वर्णित क्षेत्र को छोड़कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3853</td><td>क्रास रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3854</td><td>न्यू सर्वे रोड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3855</td><td>जबर क्षेत्र  से आगे नगर पालिका परिषद मसूरी सीमा में दोनों ओर की सम्पत्तियों हेतु ।</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3856</td><td>सिस्टर बाजार से आगे जबर खेत का क्षेत्र मंलिगार गेट से आगे मसूरी-टिहरी रोड पर जवर खेत का क्षेत्र (कम्युनिटी हास्पिटल, बुड स्टाक स्कूल, बुड स्टाक धोबीघाट, के साथ ही इस मार्ग से सम्पत्तियों के पहुच तक के लिए तथा मसूरी-चम्बा टिहरी बाई पास मार्ग की दोनों ओर की सम्पत्तियों हेतु)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3857</td><td>350 मीटर (मसूरी चकराता रोड) कैम्पटी रोड के पश्चात भिलाडू के सम्पूर्ण क्षेत्र नगर पालिका परिषद, मसूरी सीमा तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3858</td><td>लण्ढोर अनुपम होटल से नीचे भण्डारी निवास, रावत हाऊस के पश्चात खच्चरखाना लक्ष्मणपुरी क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3859</td><td>गांधी द्वारा के किंकेग मोटर मार्ग से 350 मीटर दूरी के पश्चात तथा देहरादून की ओर तथा आई.टी.बी.पी. का क्षेत्र तथा कार्टमेकेन्जी रोड नगर देवता मन्दिर का क्षेत्र गांधी द्वारा तथा उक्त मोटर मार्ग के दोनों ओर की भूमि (थापर टेरस, जय निवास, हुसैन गंज , विल्ला फॉल आदि का सम्पूर्ण क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3860</td><td>अनुपम होटल से मंलिगार क्षेत्र चौक तक का पूरा (कैन्ट क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3861</td><td>चार्लीविली गेट के नीचे हैप्पी वैली, के साथ ही पोलोग्राउण्ड का सम्पूर्ण  क्षेत्र तथा देवदार रोड होते हुए तिब्बतन होम फाउण्डेसन के साथ ही इस क्षेत्र में नगर पालिका परिषद, मसूरी सीमा तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3862</td><td>हाथीपांव व आसपास के क्षेत्र जहां पर खनन कार्य किया जाता था, पार्क एस्टेट, क्लाउड एण्ड जार्ज एवरेस्ट का सम्पूर्ण क्षेत्र ग्राम दुधली तक नगर पालिका परिषद मसूरी सीमान्तर्गत)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3863</td><td>पिक्चर पैलेस से लण्ढौर बाजार का पूरा क्षेत्र अनुपम होटल तक (बूचडखाना, अनुपम चौक गुरूद्वारा रोड से भण्डारी निवास, रावत हाऊस तक)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3864</td><td>मसूरी इंटरनेशनल स्कूल सीमा समाप्ति पर उससे आगे कैम्पटी फाल रोड (मसूरी से चकराता) पर नगर पालिका सीमा मसूरी तक के दोनों ओर के भाग के लिए (श्रीनगर इस्टेट)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3865</td><td>मंलिगार होटल से ऊपर का क्षेत्र 4 दुकान होकर सिस्टर बाजार से दूरदर्शन केन्द्र तक का क्षेत्र चार दुकान से र्सीक वाली कोठी तक का क्षेत्र, र्सीक वाली कोठी से लाल टिब्बा के पिछे की ओर की सड़क का पूरा क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3866</td><td>कचहरी के उपर एवोलोन गनहिल रोड को जोड़ने वाला तिराहा के पाश्चात का पूरा क्षेत्र सेन्ट मेरी अस्पताल व साहू जैन इस्टेट व पोंदार हाउस के पश्चात का सम्पूर्ण ऊपरी भाग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3867</td><td>घंघटार लण्ढौर से साउथ रोड होकर  सिविल अस्पताल, वाईन वर्ग ऐलन स्कूल एवं बाला हिसार क्षेत्र (घन्टाघर से बालाहिसार तक जिसे पुराना राजपुर रोड से भी जाना जाता है)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3869</td><td>जीरो पॉइंट से आगे हरनाम सिंह रोड पर वेवरली कान्वेन्ट स्कूल (काला स्कूल गेट) से पूर्व का सम्पूर्ण क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3870</td><td>चार्लीविला गेट से डिक रोड होकर कम्पनी बाग, लौगी गार्डन, होलो ओक का सम्पूर्ण क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3871</td><td>नगर पालिका परिषद, मसूरी में सम्मिलित ग्राम मिसरासपट्टी का क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3872</td><td>भट्टा गॉव नगर पालिका सीमा के अन्दर का भाग के लिए मार्ग के दोनों ओर के भाग (देहरादून- मसूरी मार्ग हेतु निर्धारित 350 मीटर दूरी को छोड़ कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3873</td><td>होटल सेवेन ओक्स से आगे कैमल्स बैक रोड पर बहुगुणा पार्क से पूर्व तक (मार्ग के दोनों ओर पहुच सम्पत्तियों तक के लिए</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3874</td><td>कम्पनी बाग लौगी गार्डेन के पश्चात हाथी पांव चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3875</td><td>घोबीघाट मसूरी झील के पश्चात ग्राम भट्टा तक नगर पालिका परिषद मसूरी सीमा में (देहरादून- मसूरी मार्ग हेतु निर्धारित 350 मीटर दूरी को छोड़ कर)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3876</td><td>बड़े मोड के अंतिम छोर के पाश्चात से किंकेग मोटर मार्ग पर दोनों ओर 350 मीटर की परिधि में किंकेग से नीचे घनानन्द रा.इ.का. के पश्चात देहरादून की ओर धोबीघाट का क्षेत्र नगर पालिका परिषद, मसूरी सीमा अन्तर्गत कीलिफ़ हाल इस्टेट का सम्पूर्ण क्षेत्र)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3877</td><td>राधा भवन इस्टेट, मुख्य भाग से आगे की ओर गुरूनानक स्कूल से सड़क से ऊपरी भाग न्यू सर्कुलर रोड से मानव भारती संगीला एस्टेट क्षेत्र कम्पनी बाग उपरी क्षेत्र वेवरली कान्वेंट स्कूल (काला स्कूल) गेट तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3878</td><td>लाइब्रेरी चौक से होटल क्लासिक तथा लाइब्रेरी बस स्टैन्ड से नीचे की ओर 350 मीटर दूरी के पश्चात मुख्य मेनर हाउस भवन तथा सर्कुलर रोड एवं सप्रिंग रोड मोतीलाल नहरू रोड से लेकर सम्पूर्ण चमर खण्ड का क्षेत्र, मैकनेन पम्प क्षेत्र, ऐस्टल इस्टेट का सम्पूर्ण क्षेत्र, आई0टी0बी0पी0 गेट से पहले तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3879</td><td>चकराता रोड पर सा0नि0वि0 निरीक्षण भवन मसूरी के क्षेत्र से आगे चकराता टोल में मसूरी इंटरनेशल स्कूल तक पोलो ग्राउन्ड क्षेत्र तक 100 मीटर रोड क्षेत्र की ओर(श्रीनगर इस्टेट)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3880</td><td>झडीपानी क्षेत्र (ओकग्रोव स्कूल का क्षेत्र, झडीपानी टोल के साथ ही राजपुर पुराना टोल नगर पालिका परिषद, मसूरी सीमान्तर्गत)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3881</td><td>बार्लोगंज क्षेत्र (जेपी बैड से बार्लोगंज मार्ग की सम्पूर्ण सम्पत्तियों हेतु, बालाहिसार मार्ग पर बालाहिसार के पश्चात सम्पूर्ण मैरीविल एस्टेट, भट्टा गॉव नगर पालिका सीमा तक, देहरादून-मसूरी मार्ग हेतु निर्धारित 350 मीटर दूरी को छोड़कर सम्पूर्ण बार्लोगंज-झडीपानी मार्ग पर स्थित भूमि भवन जो नगर पालिका परिषद मसूरी की सीमा के अन्तर्गत हो)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3882</td><td>लाइब्रेरी चौक से आगे मोतीलाल नहरू मार्ग पर दोनो ओर पहुच मार्ग (काला स्कूल) वेवरली कान्वेंट स्कूल तक का क्षेत्र ।</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3883</td><td>मसूरी मार्डन स्कूल तिराहे से राधा भवन मसूरी मुख्य भवन से होते हुए मान काटेज, बडौदा हाऊस चण्डालगढी क्षेत्र एवं विन्सेट हिल का सम्पूर्ण ऊपरी क्षेत्र</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6288</td><td>पिक्चरपैलेस के ऊपर नगर पालिका परिषद कार्यालय मसूरी, हिमालय क्लब नान पारा हो कर आर एन भार्गव इंटर कॉलेज मार्ग होते हुये वाइन वर्ग एलेन स्कूल प्राइमरी सेक्शन तक तथा घंटा घर से ओकबुश रोड होते हुये</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3884</td><td>इन्द्राभवन से आगे चार्लीविली गेट तक (साथ ही इस मार्ग से सम्पत्तियों तक की पहुच हेतु)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3885</td><td>लाईब्रेरी चौक के बाद आगे इन्द्रा भवन तक (होटल ओएसेज मार्ग, गाडीखाना, सेवाय होटल स्टाफ क्वाटर्स का भाग, इन्दिरा भवन आदि के साथ ही इस मार्ग से सम्पत्तियों तक की पहुच हेतु)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3886</td><td>माल रोड पर रोजलीन होटल से होते हुए कैमल बैक रोड पर बहुगुणा पार्क तक का भाग (प्राईमरी पाठशाला लाईब्रेरी भिलाडू मार्ग पर मित्तल हाउस व धर निवास आदि तक का अन्तिम भाग )</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3887</td><td>लाइब्रेरी चौक से संपूर्ण माल रोड कुलड़ी बाज़ार, जफर हाल , स्टुडियो लौज़, तिलक मार्ग , बारह कैंची पर डॉक्टर ठुकराल के आगे वाले किंक्रग की ओर वाले बंद तक सड़क के दोनों ओर 50 मीटर तक कैमल बैंक रोड पर होटल नन्द विला एवं होटल सोलिटेयर प्लाज़ा तक (दुग्गल विला का गुनसोला निवास दुग्गल विला कॉटेज, रोज़लीन होटल से कालाकाकर हाउस एवम चर्च रोड पर पोदार हाउस आदि तक का भाग, कचहरी रोड पर एवलॉन-गनहिल मार्ग को जोड़ने वाला तिराहा, हैकमन्स होटल मे शगुन पैलेस, घोडा लाइन, हम्पटन कोर्ट, क्रेग कालिज आदि के साथ ही एस्टेला कालिज, लॉलर बैक, तिब्बतन मार्केट मार्ग पर इन्दर निवास पदमनी आदि के साथ ही वासू सिनेमा बिल्डिंग आदि)</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3991</td><td>डोईवाला टाउन एरिया का शेष क्षेत्र0</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3992</td><td>डोईवाला चौक से शुगर मिल प्रेम नगर बाज़ार चादमारी चौक तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3993</td><td>डोईवाला चौक से रेल्वे स्टेशन रोड पर रेल्वे स्टेशन तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3994</td><td>डोईवाला चौक से देहारादून रोड पर टाउन एरिया सीमा समाप्ती तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3995</td><td>डोईवाला चौक से ऋषिकेश रोड पर सौंग नदी तक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3996</td><td>मारखम ग्रन्ट- ।</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3997</td><td>मिस्सरवाला खुर्द</td></tr><tr><td>4</td><td>1</td><td>5</td><td>3999</td><td>हंसूवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4000</td><td>डोईवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4001</td><td>घिसरपड़ी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4002</td><td>मिस्सरवाला कलां</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4003</td><td>लच्छीवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4004</td><td>डैशवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4005</td><td>गुजरमी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4006</td><td>जगातखाना, जगातखाना करनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4007</td><td>डोमगांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4008</td><td>भंडारीवाला मयचक</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4009</td><td>मंगलूवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6289</td><td>भण्डारी वाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4010</td><td>विजयपुर गोपीवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4011</td><td>लाडपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4012</td><td>गुजराडा मानसिंह</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4013</td><td>आरकेडिया ग्रांट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4014</td><td>नवादा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4015</td><td>नथुवावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4016</td><td>चंद्रबनी ग्रांट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4017</td><td>चकतुनवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4018</td><td>चकरायपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4019</td><td>दानियों का डांडा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4020</td><td>सेवलाखुर्द</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4021</td><td>सुन्दरवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4022</td><td>सौन्धोवाली ,सौन्धोवाली धौरन</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4023</td><td>रायपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4024</td><td>हर्रावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4025</td><td>हरभजवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4026</td><td>हरबंश वाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4027</td><td>हरिपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4028</td><td>सिनौला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4029</td><td>पित्थूवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4030</td><td>मियांवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4031</td><td>किरसाली पछवादून</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4032</td><td>मेहुवाला माफी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4033</td><td>माजरी माफी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4034</td><td>मोहकमपुर कलां</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4035</td><td>मोहकमपुर खुर्द</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4036</td><td>मोहब्बेवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4037</td><td>मक्कावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4038</td><td>कुवांवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4039</td><td>कुठाल गांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4040</td><td>आसारोडी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4041</td><td>चन्द्रबनी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4042</td><td>चन्द्रबनी खालसा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4043</td><td>विजयपुर हाथीबड़कला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4044</td><td>मिटठी भेडी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4045</td><td>मरेठा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4046</td><td>कुल्हान करनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4047</td><td>कुल्हान मानसिंह</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4048</td><td>सोन्धोवाली मानसिंह</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4049</td><td>नागल हटनाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4050</td><td>हटनाल गांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4051</td><td>आमवाला करनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4052</td><td>कालागांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4053</td><td>चांलग</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4054</td><td>आमवाला उपरला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4055</td><td>आमवाला मझला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4056</td><td>किरसाली परवादून</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4057</td><td>तरलानांगल</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4058</td><td>ननूरखेडा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4059</td><td>बालावाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4060</td><td>बगराल गांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6290</td><td>नकरौंदा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6291</td><td>जोहड़ी</td></tr><tr><td>4</td><td>1</td><td>5</td><td>6292</td><td>मोथरोंवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4061</td><td>भंडारगाँव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4062</td><td>खुरावा</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4063</td><td>खाला गांव</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4064</td><td>आमवाला तरला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4065</td><td>नत्थनपुर</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4066</td><td>डांडा नूरीवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4067</td><td>डांडा लखौण्ड</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4068</td><td>डांडा खुदानेवाला</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4069</td><td>डांडा धोरण</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4070</td><td>सेवलाकलां</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4071</td><td>भारुवालाग्रान्ट</td></tr><tr><td>4</td><td>1</td><td>5</td><td>4072</td><td>मासली</td></tr></tbody></table>


# Property Bifurcation

## Introduction&#x20;

**What does bifurcation of property mean?**

* A property is divided into two or more parts.&#x20;
* New properties which come into existence are called child properties.&#x20;
* The property that got bifurcated is known as parent property.&#x20;
* The owner(s) of the parent and child properties remain the same.&#x20;
* The relationship of child and parent properties is maintained to track the bifurcation.&#x20;
* Change in ownership of child properties is achieved through the Mutation (Title Transfer) process.&#x20;
* A building property can be divided into.&#x20;
  * Building + Building&#x20;
  * Building + Vacant Land&#x20;
* A vacant land property can be divided into vacant lands only.

**How is the bifurcation of property accomplished on the ground?**

The bifurcation is considered a service and the owner(s) has to apply for it. An application is submitted for a property bifurcation with the required supporting documents. There is no fee associated with the bifurcation of property application.

## Key Metrics&#x20;

Below are state-wise approximate figures of amalgamation applications received and processed in a year.

| State             | On the basis of                                       | No. of applications received/ processed |
| ----------------- | ----------------------------------------------------- | --------------------------------------- |
| Andhra Pradesh    | On basis of data available in the property tax system | 1624                                    |
| Punjab            | On the basis of application received manually         |                                         |
| Uttarakhand       | On the basis of application received manually         |                                         |
| Cantonment Boards | On the basis of application received manually         |                                         |
| Orissa            | On the basis of application received manually         |                                         |

## Proposed Solution&#x20;

**How to achieve this with the DIGIT Platform?**

1. A new application type ‘BIFURCATION’ is created.&#x20;
2. The no. of properties resulting due to bifurcation is restricted to five which is configurable and can be changed according to the need of implementations.&#x20;
3. The application number format is defined and configured.&#x20;
4. Only one application is created and the record of the same is maintained and the new properties created as a result of bifurcation are linked to that application.&#x20;
5. The workflow component is integrated.&#x20;
6. The status of parent and child properties is maintained as ‘In Workflow’ while the application is in flow.&#x20;
7. On the approval of the application, bifurcation comes into effect and all the properties become active.&#x20;
8. Newly created properties are given a new property ID.&#x20;
9. Though there are no instances where the application fee is charged for bifurcation, the applicability of the application fee is to be made configurable.&#x20;
10. Bifurcation comes into effect from the date of approval of the application.&#x20;
11. No final document is generated as proof of bifurcation.&#x20;
12. Applicant(s) is/are intimated through SMS/ email notifications about the status and completion of the application.&#x20;

**Validations**&#x20;

1. The parent property should be active.&#x20;
2. Ownership of all the properties (parent + child) remains the same.&#x20;
3. The total land area of the parent property (before bifurcation) should be equal to the total land area of all the properties (parent + child).&#x20;
4. The total built-up area of the parent property (before bifurcation) should be equal to the total built-up area of all the properties (parent + child).&#x20;
5. All the child properties inherit the ownership from the parent property.&#x20;

## User Persona

<table><thead><tr><th width="106">S.No.</th><th>As a</th><th>&#x3C;Role></th><th>I want</th><th>&#x3C;What></th><th>so that</th><th>&#x3C;Why></th></tr></thead><tbody><tr><td>1.</td><td>As a</td><td>Employee orCitizen</td><td>I want</td><td>Search a property by unique property ID</td><td>so that</td><td>I can create an application for bifurcation of property.</td></tr><tr><td>2.</td><td>As a</td><td>Employee orCitizen</td><td>I want</td><td>Search a property by owner’s mobile no.</td><td>So that</td><td>I can create an application for bifurcation of property.</td></tr><tr><td>3.</td><td>As a</td><td>Employee or Citizen</td><td>I want</td><td>Search a property by owner’s name or by door no.</td><td>So that</td><td>I can create an application for bifurcation of property.</td></tr><tr><td>3.</td><td>As a</td><td>Employee orCitizen</td><td>I want</td><td>Initiate new application for property bifurcation</td><td>So that</td><td>I can create an application to bifurcate a property.</td></tr><tr><td>4.</td><td>As a</td><td>Citizen</td><td>I want</td><td>Notification for my property bifurcation application</td><td>So that</td><td>I can keep track of my application (notification sent will be according to workflow)</td></tr><tr><td>5.</td><td>As a</td><td>Employee (Workflow)</td><td>I want</td><td>Bifurcation application in my inbox</td><td>So that</td><td>I can take appropriate action on the application.</td></tr><tr><td>6.</td><td>As a</td><td>Employee</td><td>I want</td><td>Search application</td><td>So that</td><td>I can search and see the application details.</td></tr><tr><td>7.</td><td>As a</td><td>Citizen</td><td>I want</td><td>My Applications</td><td>So that</td><td>I can see the application details and keep track of the application.</td></tr></tbody></table>

## Navigation&#x20;

### Employee&#x20;

Login → Search Property → View Property Details → Select ‘Bifurcate Property’ Action.&#x20;

### Citizen&#x20;

Login → Bifurcate Property → Search Property → Search Result → Select Property.

### Application No. Format&#x20;

Application no. should follow the given format - PT-\<runningsequence>

## User Flow&#x20;

1. Citizen/ Counter Employee - Application is initiated by citizen/ counter employee.&#x20;
2. Document Verification - The application and documents attached to it are verified by a document verifier.&#x20;
3. Field Inspection - The field inspector performs the field visit for the physical verification of properties.&#x20;
4. Approval of application - In the case no application fee is applicable, the application is approved and bifurcation comes into effect with approval.&#x20;
5. Payment of application fee - In the case the application fee is applicable, bifurcation comes into effect only after the payment of the application fee.

<figure><img src="/files/BwxZ9P55sc1fHdDSMI0I" alt=""><figcaption></figcaption></figure>

### Application Form

<table><thead><tr><th>Field Name</th><th width="174">Data Type</th><th width="137">Is Mandatory?</th><th>Description</th></tr></thead><tbody><tr><td><strong>Property Address</strong></td><td><br></td><td><br></td><td><br></td></tr><tr><td>Pincode</td><td>Display</td><td>Yes</td><td>Pincode of area property is located.</td></tr><tr><td>City</td><td>Display</td><td>Yes</td><td>City name of the property.</td></tr><tr><td>Locality/ Mohalla</td><td>Display</td><td>Yes</td><td>Locality or mohalla name property is located.</td></tr><tr><td>Street Name</td><td>Display</td><td>Yes</td><td>Street name property is located.</td></tr><tr><td>Door No./ House No.</td><td>Display</td><td>Yes</td><td>House or door no. of the property.</td></tr><tr><td><strong>Ownership Details</strong></td><td><br></td><td><br></td><td><br></td></tr><tr><td>Ownership Type</td><td>Display</td><td>Yes</td><td>Display of ownership type.</td></tr><tr><td>Institution Name</td><td>Display</td><td>Yes</td><td>It is applicable for the ownership type institution.</td></tr><tr><td>Institution Type</td><td>Display</td><td>Yes</td><td>It is applicable for the ownership type institution.</td></tr><tr><td>Name</td><td>Display</td><td>Yes</td><td>Name of the owner of property or the authorized person in case of institutional property.</td></tr><tr><td>Guardian Name</td><td>Display</td><td>Yes</td><td>Name of guardian and applicable for single and multiple ownership type only.</td></tr><tr><td>Gender</td><td>Display</td><td>Yes</td><td>Gender of owner/authorized person of the property.</td></tr><tr><td>Landline No.</td><td>Display</td><td>Yes</td><td>Office landline no. in case of institutional ownership.</td></tr><tr><td>Mobile No.</td><td>Display</td><td>Yes</td><td>Mobile no. of the owner/ authorized person.</td></tr><tr><td>Designation</td><td>Display</td><td>Yes</td><td>Designation of the authorized person</td></tr><tr><td>Email </td><td>Display</td><td>Yes</td><td>Email address of owner/ authorized person.</td></tr><tr><td>Corresponding Address</td><td>Display</td><td>Yes</td><td>Corresponding address of the owner/ authorized person.</td></tr><tr><td><strong>Assessment Details</strong></td><td><br></td><td><br></td><td><br></td></tr><tr><td>Property Type</td><td>Drop-down</td><td>Yes</td><td>Type of property</td></tr><tr><td>Property Usage</td><td>Drop-down</td><td>Yes</td><td>Usage of property, residential, non-residential, or mixed.</td></tr><tr><td>Plot Size (In Sq. Ft.)</td><td>Textbox</td><td>Yes</td><td>Total area of land in square feet on which the property is constructed.</td></tr><tr><td>Unit 1</td><td><br></td><td><br></td><td><br></td></tr><tr><td>Floor No.</td><td>Drop-down</td><td>Yes</td><td>Floor no. unit is located.</td></tr><tr><td>Usage</td><td>Drop-down</td><td>Yes</td><td>Usage of unit, residential/ non-residential.</td></tr><tr><td>Sub-usage</td><td>Drop-down</td><td>Yes</td><td>Sub-usage of unit, mandatory in case of non-residential usage.</td></tr><tr><td>Occupancy</td><td>Drop-down</td><td>Yes</td><td>The type of occupancy of property.</td></tr><tr><td>Annual Rent</td><td>Textbox</td><td>Yes</td><td>Annual rent in INR, in case property is rented out.</td></tr><tr><td>Built-up Area</td><td>Textbox</td><td>Yes</td><td>Built-up area of the unit in square feet.</td></tr><tr><td>Child Propertie(s)</td><td><br></td><td><br></td><td><br></td></tr><tr><td>Add Child Property</td><td>Icon</td><td>Yes</td><td>To add child property.</td></tr><tr><td>Property 1</td><td><br></td><td><br></td><td><br></td></tr><tr><td>Property ID</td><td>Display</td><td>Yes</td><td>Unique Property ID.</td></tr><tr><td>Door/ House No.</td><td>Display</td><td>Yes</td><td>House no./ Door no. of newly created child property.</td></tr><tr><td>Property Type</td><td>Display</td><td>Yes</td><td>Type of property of child property.</td></tr><tr><td>Property Usage</td><td>Display</td><td>Yes</td><td>Usage of child property, residential, non-residential, or mixed.</td></tr><tr><td>Plot Size (In Sq. Ft.)</td><td>Display</td><td>Yes</td><td>Total area of land in square feet on which the child property is constructed.</td></tr><tr><td>No. of floors</td><td>Display</td><td>Yes</td><td>No. of floors child property is having.</td></tr><tr><td>Total Builtup Area (Sq. Ft.)</td><td>Display</td><td><br></td><td>Total built-up area of the child property across all the floors.</td></tr><tr><td>Property 2</td><td><br></td><td><br></td><td><br></td></tr><tr><td>Property ID</td><td>Display</td><td>Yes</td><td>Unique Property ID.</td></tr><tr><td>Door/ House No.</td><td>Display</td><td>Yes</td><td>House no./ Door no. of newly created child property.</td></tr><tr><td>Property Type</td><td>Display</td><td>Yes</td><td>Type of property of child property.</td></tr><tr><td>Property Usage</td><td>Display</td><td>Yes</td><td>Usage of child property, residential, non-residential, or mixed.</td></tr><tr><td>Plot Size (In Sq. Ft.)</td><td>Display</td><td>Yes</td><td>Total area of land in square feet on which the child property is constructed.</td></tr><tr><td>No. of floors</td><td>Display</td><td>Yes</td><td>No. of floors child property is having.</td></tr><tr><td>Total Builtup Area (Sq. Ft.)</td><td>Display</td><td><br></td><td>Total built-up area of the child property across all the floors.</td></tr><tr><td>View Property Details/ Remove Property</td><td>Hyperlink</td><td>Yes</td><td>To view the completed property details/ remove the added property.</td></tr><tr><td>Documents</td><td>File Picker</td><td>Yes</td><td>The documents required to process the request.</td></tr><tr><td>Timelines</td><td>Workflow</td><td>Yes</td><td>Display of workflow steps completed.</td></tr></tbody></table>

### Child Property Form

<table><thead><tr><th>Field Name</th><th width="146">Data Type</th><th>Is Mandatory?</th><th>Description</th></tr></thead><tbody><tr><td>Property ID</td><td>Display</td><td>Yes</td><td>Unique Property ID.</td></tr><tr><td>Door/ House No.</td><td>Display</td><td>Yes</td><td>Full address of property.</td></tr><tr><td>Assessment Details</td><td></td><td></td><td></td></tr><tr><td>Property Type</td><td>Drop-down</td><td>Yes</td><td>Type of property</td></tr><tr><td>Property Usage</td><td>Drop-down</td><td>Yes</td><td>Usage of property, residential, non-residential, or mixed.</td></tr><tr><td>Plot Size (In Sq. Ft.)</td><td>Textbox</td><td>Yes</td><td>Total area of land in square feet on which the property is constructed.</td></tr><tr><td>Unit 1</td><td></td><td></td><td></td></tr><tr><td>Floor No.</td><td>Drop-down</td><td>Yes</td><td>Floor no. unit is located.</td></tr><tr><td>Usage</td><td>Drop-down</td><td>Yes</td><td>Usage of unit, residential/ non-residential.</td></tr><tr><td>Sub-usage</td><td>Drop-down</td><td>Yes</td><td>Sub-usage of unit, mandatory in case of non-residential usage.</td></tr><tr><td>Occupancy</td><td>Drop-down</td><td>Yes</td><td>The type of occupancy of property.</td></tr><tr><td>Annual Rent</td><td>Textbox</td><td>Yes</td><td>Annual rent in INR, in case property is rented out.</td></tr><tr><td>Built-up Area</td><td>Textbox</td><td>Yes</td><td>Built-up area of the unit in square feet.</td></tr></tbody></table>

### Workflow

<table><thead><tr><th width="120">S.No.</th><th>Action</th><th>Role</th><th>From State</th><th>To State</th></tr></thead><tbody><tr><td>1</td><td>Initiate Application</td><td>Citizen/ Counter Employee</td><td></td><td>Initiated</td></tr><tr><td>2</td><td>Submit Application</td><td>Citizen/ Counter Employee</td><td>Initiated</td><td>Pending for document verification</td></tr><tr><td>3</td><td>Verify and Forward</td><td>Document Verifier</td><td>Pending for document verification</td><td>Pending for field inspection</td></tr><tr><td>4</td><td>Verify and Forward</td><td>Field Inspector</td><td>Pending for field inspection</td><td>Pending approval for bifurcation</td></tr><tr><td>5</td><td>Send Back</td><td>Document Verifier</td><td>Pending for document verification</td><td>Pending for citizen action</td></tr><tr><td>6</td><td>Send Back</td><td>Field Inspector</td><td>Pending for Field inspection</td><td>Pending for document verification</td></tr><tr><td>7</td><td>Send Back</td><td>Approver</td><td>Pending approval for bifurcation</td><td>Pending for field inspection</td></tr><tr><td>8</td><td>Send Back To Citizen</td><td>&#x3C;roles having access></td><td>&#x3C;Current Status></td><td>Pending for citizen action</td></tr><tr><td>9</td><td>Re-submit</td><td>Citizen/ Counter Employee</td><td>Pending for citizen action</td><td>Pending for document verification</td></tr><tr><td>10</td><td>Re-submit</td><td>Document Verifier</td><td>Pending for document verification</td><td>Pending for field inspection</td></tr><tr><td>11</td><td>Re-submit</td><td>Field Inspector</td><td>Pending for field inspection</td><td>Pending approval for bifurcation</td></tr><tr><td>12</td><td>Approve</td><td>Approver</td><td>Pending approval for bifurcation</td><td>Approved</td></tr><tr><td>13</td><td>Reject</td><td>&#x3C;roles having access></td><td>&#x3C;Current Status></td><td>Rejected</td></tr></tbody></table>

### Wireframes

Figma Link - <https://www.figma.com/file/AXXM9veAvX5IRazkhwbvqF/Digit-Design-System?node-id=38193%3A82388>

### Screenshots

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td>My properties and selecting a property for bifurcation. The property should not be inactive or in the workflow.</td><td><img src="/files/0dgzd0Ub9Y0kcaywPM58" alt=""></td><td></td></tr><tr><td>Parent property address and ownership details are displayed.</td><td><img src="/files/oKNeQCGfKN6404lVV9kI" alt=""></td><td></td></tr><tr><td><p>Parent property assessment details are edited and the flow of screens is according to the property type of the parent property.</p><ol><li>Property Type: Individual Building</li></ol></td><td><img src="/files/LM8IbQynvIoBUqiiLOaN" alt=""></td><td><img src="/files/rdgU7fCi07a1Qk1VynfM" alt=""></td></tr><tr><td>Property Type: Flat/ Part of building</td><td><img src="/files/NB6RFOQ4HeHVt03BiyVD" alt=""></td><td></td></tr><tr><td>Property Type: Vacant Land</td><td><img src="/files/C9khzNe5UATk3DSVvDoM" alt=""></td><td></td></tr><tr><td><p>Child property (ies) is/are added to the application. To add the child property, the flow of property registration is used with the below-given limitations.</p><ol><li>Pincode, City, Locality and Street Name is inherited from parent property and are not allowed to edit. The House/ Door No. is entered newly. </li><li>Ownership and owner details are also inherited from parent property and are not allowed to edit.</li><li>The assessment details are entered afresh following the validations about the parent and child properties.</li></ol></td><td><img src="/files/Iv8W84c1rGBVDNsz6gaS" alt=""></td><td></td></tr><tr><td>Documents and application summary page are displayed.</td><td><img src="/files/Z5MUtxhZAtfeHNPZDV50" alt=""></td><td></td></tr></tbody></table>

## Use Case Scenarios

**UC1: There is property ‘A’ which has to be divided into 2 properties of the same usage and in the name of the same owner(s).**

1. One new property ‘B’ record is created keeping the address and owner(s) details the same as property ‘A’.
2. New door no. is provided to property ‘B’.
3. Assessment detail is added to newly created property ‘B’ keeping usage the same as ‘A’.
4. Property ‘A’ is modified to change the assessment details while the change in address and owner’s detail is now allowed.

**UC2: There is property ‘A’ which has to be divided into 2 properties of different usage and in the same of the same owner(s).**

1. One new property ‘B’ record is created keeping the address and owner(s) details the same as property ‘A’.
2. New door no. is provided to property ‘B’.
3. Assessment detail is added to the newly created property ‘B’.
4. Property ‘A’ is modified to change the assessment details while the change in address and owner’s detail is now allowed.

**UC3: There is property ‘A’ which has to be divided into 2 properties and for the second property owner(s) to be changed.**

1. Property ‘A’ is modified to change the assessment details while the change in address and owner’s detail is now allowed.
2. One new property ‘B’ record is created keeping the address and owner(s) details the same as property ‘A’.
3. New door no. is provided to property ‘B’.
4. Assessment detail is added to the newly created property ‘B’.
5. Once the bifurcation application is closed, a mutation application seeking change in the owner(s) is applied either for newly created property ‘B’ or existing property ‘A’ based on the need.

**UC4: There is property ‘A’ which has to be divided into 2 properties and for both properties' owner(s) to be changed.**

1. Property ‘A’ is modified to change the assessment details while a change in address and owner’s details is now allowed.
2. One new property ‘B’ record is created keeping the address and owner(s) details the same as property ‘A’.
3. New door no. is provided to property ‘B’.
4. Assessment detail is added to the newly created property ‘B’.
5. Once the bifurcation application is closed, mutation applications seeking change in the owner(s) are applied for newly created property ‘B’ and existing property ‘A’.


# Property Tax System User Manual

An illustrative guide to using the property tax module

## **Introduction to PT**

The Property Tax (PT) module offers the citizens and governance bodies a convenient and transparent means of processing property taxes. Local governing bodies identify the applicable tax slabs for different types of properties. The PT module assesses properties, calculates tax amounts, processes tax payments and generates tax collection reports.

{% hint style="info" %}
**Tip:** Click on the links on the flow diagram below to access the docs for the specified action.&#x20;
{% endhint %}

{% embed url="<https://www.canva.com/design/DAGQbq7F9E8/03zHowujcuDu79CxOfZ_zw/view?utm_content=DAGQbq7F9E8&utm_campaign=designshare&utm_medium=link&utm_source=editor>" %}
Property Tax module user workflow
{% endembed %}

## Using Property Tax Module

This section guides you through the details of using the PT module for each role. Click on the relevant role below to learn more about how to use the PT system.

1. [Citizens](/local-governance/access/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual)
2. [Counter Employee (CE)](/local-governance/access/local-governance-stack/property-tax/pt-user-manual/citizen-user-manual#citizens-and-ce)
3. [Document Verifier (DV)](/local-governance/access/local-governance-stack/property-tax/pt-user-manual/employee-user-manual#document-verifier-dv)
4. [Field Inspector (FI)](/local-governance/access/local-governance-stack/property-tax/pt-user-manual/employee-user-manual#field-inspector-fi)
5. [Approver](/local-governance/access/local-governance-stack/property-tax/pt-user-manual/employee-user-manual#approver)


# Property Tax System Citizen User Manual

Learn how to add new property, assess or transfer property and pay property tax

## **Citizens**  <a href="#citizens-and-ce" id="citizens-and-ce"></a>

Citizens represent individuals, communities, or business entities who are the system end-users. The PT module allows property owners to register their property details online. These details are then used for various property-related transactions.

![](https://lh6.googleusercontent.com/E-gX6Dh7fXkxJuRJEA74bGKMwMiUCsNySJLlHzOTa5FAPk8lC0UzEJuD5TJvlKSeljI25Je_X7njq6S4EkdeDoCXYws67l43AeqOrd_R_lexJ7YJiP3zbQpE4gZVjfNbfrZKc3DR)

The citizen can also approach the Counter Employee (CE) to register new property, assess property or pay property tax.

**The citizen can -**

* ​[Register New Property](#add-new-property)​
* [Search & Pay​](#search-property)
* [​My Bills](#view-and-pay-bills)
* [My Payments​](#my-payments)
* [​My Properties](#view-registered-properties)
* [​My Applications](#view-applications)
* [Update Property](#update-property)
* ​​[Transfer Property Ownership​](#transfer-property-ownership)
* ​[Update Mobile Number](#update-mobile-number)&#x20;


# Register Property

{% embed url="<https://www.youtube.com/watch?v=X5yPbLF9o4E>" %}

| <img src="/files/8lhyCnqpNVAZMUCuPPGA" alt="" data-size="original">                                                                                                                               | <img src="/files/d8MisNLi99JzED3ytVmx" alt="" data-size="original">                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Log in to the system. </p><p>Click on the <strong>Register Property</strong> option on the home page.</p>                                                                                      | The screen displays the **Required Documents** list. Note the list of documents valid for address, identity, registration, usage, special category, and occupancy proofs.                                                                                                                       |
| <img src="/files/x7QnNRxhE1GWsU2MuVUf" alt="" data-size="original">                                                                                                                               | <img src="/files/Mp6g3QdAuIgBCnk3Fw0q" alt="" data-size="original">                                                                                                                                                                                                                             |
| Click on **Next** to move on to the next screen. Answer Yes or No to the question **Is this a Residential Property?** Click on the **Next** button.                                               | Select the relevant option on the screen to indicate the **Type of Property**.                                                                                                                                                                                                                  |
| <img src="/files/1xUjDtxd7D68Z6Axx4Rn" alt="" data-size="original">                                                                                                                               | <img src="/files/U6TeMfVmmoXOX3AUoHWV" alt="" data-size="original">                                                                                                                                                                                                                             |
| Enter the **Plot Size** in square feet.                                                                                                                                                           | Select the correct option to indicate the **Number Of Floors.**                                                                                                                                                                                                                                 |
| <img src="/files/eckkrtOmH562XfycvoUg" alt="" data-size="original">                                                                                                                               | <img src="/files/8pLXzeocRWqn2mmH41is" alt="" data-size="original">                                                                                                                                                                                                                             |
| Select the correct option to indicate the **Number of Basements**.                                                                                                                                | <p>Enter the <strong>Ground Floor Details</strong> like <strong>Unit Usage Type</strong>, <strong>Occupancy</strong>, and <strong>Total Super Built-Up Area (sq ft)</strong>. </p><p>Click on the <strong>Add One More Unit</strong> option to add G+1 or G+2 and additional floor details.</p> |
| <img src="/files/2ay0FKGK9MP6IlGf3ncB" alt="" data-size="original">                                                                                                                               | <img src="/files/hGDY1nHjF0pG7a0f6org" alt="" data-size="original">                                                                                                                                                                                                                             |
| If the **Occupancy** type is **Tenanted/Rented**, enter the **Total Annual Rent (INR)** value.                                                                                                    | In case the **Unit Usage Type** is non-residential, enter the **Sub Usage Type** details to provide information on the type of business for which the property is used.                                                                                                                         |
| <img src="/files/CnkQUTxHDGRV28LAzYPn" alt="" data-size="original">                                                                                                                               | <img src="/files/S67qksJkImD5RufTXndD" alt="" data-size="original">                                                                                                                                                                                                                             |
| Provide the **Pin Property Location** on the map if you are at the building location while submitting the registration application. You can **Skip and Continue** if you are not at the location. | Enter the Pincode of the area in response to the question **Do you know the pincode?** Click on **Skip and Continue** option if you do not know the Pincode.                                                                                                                                    |
| <img src="/files/M8rEl9tRnMF8lqk70qiR" alt="" data-size="original">                                                                                                                               | <img src="/files/rF1VgpGwDwi5YAAA0iHo" alt="" data-size="original">                                                                                                                                                                                                                             |
| Select the relevant **City** and the **Locality** from the drop-down list in the **Provide Property Address** screen to pinpoint the location of the property.                                    | Enter the **Street Name**, **Door/House No.** of the property in the **Provide Property Address** screen.                                                                                                                                                                                       |
| <img src="/files/4v2kSEzbAUb7Y9hoh6Tt" alt="" data-size="original">                                                                                                                               | <img src="/files/1ceacmqFX6rX76lH6tED" alt="" data-size="original">                                                                                                                                                                                                                             |
| Enter a suitable **Landmark** detail in the **Provide Landmark** screen to identify the property location.                                                                                        | Choose the applicable **Document Type** as a declaration of the document you want to upload as **Proof of Address**. Click on the **Choose File** button to attach the scanned copy of the selected document.                                                                                   |
| <img src="/files/TYRlFigpvgtmdRuURjH6" alt="" data-size="original">                                                                                                                               | <img src="/files/6II0oLSwq1o7fTJrR6zI" alt="" data-size="original">                                                                                                                                                                                                                             |
| Select the applicable option in the **Provide Ownership Details** screen to indicate the ownership type of the property.                                                                          | Enter details like **Name**, **Gender**, **Mobile Number**, **Guardian** and **Relationship** with the guardian in the **Owner Details** screen.                                                                                                                                                |
| <img src="/files/CZcnshpyIjOWySgPjAOe" alt="" data-size="original">                                                                                                                               | <img src="/files/9JYfsLlR4WjlFp8w39Jr" alt="" data-size="original">                                                                                                                                                                                                                             |
| Select the applicable option in the **Special Owner Category** screen to indicate if the owner belongs to a specific category.                                                                    | Enter the **Owner's Address**. Check the **Same As Property Address** box if the correspondence address of the owner is the same as the property address. The property address is auto-populated as the owner's address.                                                                        |
| <img src="/files/ZujtAApXbvZCnkILAl4S" alt="" data-size="original">                                                                                                                               | <img src="/files/n5eJ6pjvjRgzG4oqKFiW" alt="" data-size="original">                                                                                                                                                                                                                             |
| Select the **Document Type** you want to upload as **Proof of identity**. Click on **Choose File** button to attach and upload a scanned copy of the selected document.                           | Please review your application details before submitting it. In case of any changes to the submitted details click on the **Change** button adjacent to the filled-in details.                                                                                                                  |
| <img src="/files/ruc7EzMTWDT3gzKhJuju" alt="" data-size="original">                                                                                                                               | Check mark the declaration box and then click on the **Submit** button. A success message is displayed along with the application no. and unique property ID. Click on the **Download Acknowledgement Form** button to download a copy of the acknowledgement.                                  |




---

[Next Page](/llms-full.txt/1)

