Citizen Mutation Flow

Objective: To provide citizens with the functionality to apply for Ownership Transfer for an active property.

The Transfer of Ownership Option is provided to citizens on the home screen in the citizen App, under property Tax card.

Upon clicking on “Transfer Property Ownership/Mutation” link, users are taken to property search page just like in case of “search & Pay” option, where he can search for the property he wants to search the property for.

After searching the property the user is shown the property details for the properties based on the search criteria. With Total Dues on top of the card.

If there are dues owed on the property (unpaid taxes), then users are shown a popup stating that the citizen has to clear his dues first. with a proceed to pay button that takes citizens to the common pay page, just like in the case of Search & Pay.

In case of dues cleared the citizen is taken to the Docs required Page, just like in the case of Employee Mutation, where he is shown the list of docs he is supposed to have in order to be able to transfer the property.

on this page after clicking on Transfer of Ownership, the citizen is made to go through the Ownership Transfer flow where he fills in the Ownership details and Mutation Details. After completing the flow citizen is shown with the success screen with his application number and the option to download his acknowledgement as a pdf.

Technical Details

MDMS data

The MDMS data is the same as in the case of employee Mutation Screen.

API used

The citizen mutation calls the property-services/property/_update API to update the property status after that the application is gone through the Employee workflow to complete the transfer.

When Update API is called the documents are updated for the property according to the following snippet:-

        documents: [
          ...originalProperty.documents.map((oldDoc) => {
            if (mutationDocs?.PropertyTax?.MutationDocuments.some((mut) => oldDoc.documentType.includes(mut.code))) {
              return { ...oldDoc, status: "INACTIVE" };
            } else return oldDoc;
          }),
          ...newDocs,
        ],

Here originalProperty is the property data before mutation, and mutationDocs is the MDMS response for Mutation Docs.

Role Action Mapping