PT Update Number & Alternate Number

Update Mobile Number

The Update Mobile Number feature in PT

Reminds ULB users about any invalid mobile numbers that exist in the owner records and enables them to update these.
Enables ULB users to update the mobile numbers as per requests from the property owner(s).
Enables property owner(s) to update the mobile number in their record to log in to the system.

Technical Implementation Details

If the mobile number is invalid it throws a warning in the property info screen whenever the user tries to pay the dues.

Mobile Number is invalid if it doesn't match the pattern defined in the MDMS config and if the number equals to the invalid number.

MDMS Config

 "MdmsCriteria": {
        "tenantId": "pb",
        "moduleDetails": [
            {
                "moduleName": "PropertyTax",
                "masterDetails": [
                    {
                        "name": "UpdateNumber"
                    }
                ]
            }
        ]
    }

Response

invalidNumber: "9999999999"
invalidPattern: "^[6789][0-9]{9}$"
skipEnabled: true
warningEnabled: true
documents:[]

The Update number popup for employees requires a few documents to be uploaded. Citizens must provide the OTP received on the new number to update details.

Citizen view

Citizens must provide the OTP received on the new number to update details.

Update number component related files are present in the egov-ui-kit packages available in the link below.

https://github.com/egovernments/DIGIT-Dev/blob/e9c1503fc0ec75c65062b5044bfd6588ab4ee11e/frontend/mono-ui/web/rainmaker/dev-packages/egov-ui-kit-dev/src/common/propertyTax/UpdateMobile/updateMobile.jsgithub.com

API Details

Update API is used to update the property mobile number property-services/property/_update

To update the number, just update the owner.mobileNumber

To update alternate number the API used is

property-services/property/_addAlternateNumber

Update owner.alternatemobilenumber

Steps To Update Number

Click on the Edit Existing Number. A popup appears to update the number.
Enter the new number that needs to be added. Click on Send OTP.
UI makes an API call to user-otp/v1/_send with type as login to send the otp if it is registered.
In case the OTP fails then type register in the same API to create a new user.
Once the OTP is entered, it verifies and validates the user in both cases (in case of register the citizen gets registered).
Once the OTP is validated, the Property Update call is triggered to update the number in the property object.

Note: Employee users have to upload supporting documents and the property update API call is triggered directly. Steps 3,4, and 5 are skipped.

PT Alternate Number

PT Alternate Number feature enables owners to add an alternate number for the property.

We can add an alternate number while creating the property. The system also provides the option to add an alternate number after making a payment.

Alternate Number component details link

https://github.com/egovernments/DIGIT-Dev/blob/855ea3aa8df5143ffa1347fbebe4bbf7742c4596/frontend/mono-ui/web/rainmaker/dev-packages/egov-ui-kit-dev/src/common/propertyTax/AlternateMobile/index.jsgithub.com

Steps To Add Alternate Number

Click on Add Alternate Number. A popup opens to add the alternate number.
The system sends an OTP to the registered number.
Once the user enters the OTP, the system validates it.
Enter the new number that needs to be added. Click on the Send OTP button.
UI makes an API call to user-otp/v1/_send with type as login to send the OTP if it is registered.
If it fails then type register in the same API to create a new user.
Once the OTP is entered, it verifies and validates the user in both cases (in case of register the citizen gets registered).
Once the OTP is validated, the Property Update call is triggered to add the alternate number in the property object.