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:
Add data in MDMS
Refer to the table below to find the location for specific data types and its description.
Reference from Sample Data Load | Data | Location | Description |
---|---|---|---|
Tenant Details | To show the tenant at login screen | ||
|
| To enable ulb to create application,add tenant in TL module | |
Trade Type (Business Units) information | To add Business Units | ||
Create Property | To create new property.From citizen end,in create property screen,provide property Type | ||
Property Ownership Details |
| To provide type of ownership in create property screen | |
Property Owner Type | To provide owner type in create property screen |
Add boundary data
Add boundary data specific to the tenant (Refer to sample data). Reference boundary data sample.
Provide ID Format
Reference ID Format sample.
Provide Gender Type
Reference Gender Type sample.
Input Other Data
Reference - sample data for Penalty, Rebate, FinancialYear, TaxPeriod
Restart MDMS Service
Restart the mdms service and check the status in ui. The tenant is added in ui.
Create login credentials for relevant users.
Push the localisations as provided in API collection here.
Push the billing-slab of new tenant mentioned in Sample Data - TL Billing Slab.
Push the TL workflow.
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:
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
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
3. Load Workflows
Sample Data Load
Tenants
Code | Name | Description | Pincode | Logo ID | Image ID | Domain URL | Type | Twitter URL | Facebook URL | 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 | |||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
| 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 |
|
|
ca.alameda | Alameda | null | [14306,14307,14308,14309,14310] | null | 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] | null | 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 | |
---|---|---|---|---|---|---|---|---|
|
|
| New | Renewal |
|
|
|
|
Dental Lab Services | GOODS.HEALTHCARE.DENTALLABSERVICES | GROSSUNITS | ["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO"] | ["OWNERIDPROOF", "OWNERSHIPPROOF", "OWNERPHOTO", "OLDLICENCENO"] |
| 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 |
| 200.00 |
ca.alameda | PERMANENT | NEW | IMMOVABLE.PUCCA | Goods | Retail | Clothing Retail | GOODS.RETAIL.CLOTHINGRETAIL | ACC-2 | FLAT | GROSSUNITS | 0.00 | 10,000.00 |
| 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 |
|
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 |
|
Login Credentials
Role | URL |
---|---|
Employee | |
Citizen |
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 |
Role | Username | Password | ULB | ULB |
---|---|---|---|---|
Common Role for Employees Property Tax Counter Employee TL Creator TL Counter Employee Counter Employee | CSR | Demo@123 | Alameda | 6000000001 |
Common Role for Employees Property Tax Counter Employee Business License Document verifier Business License field inspector BPA Services verifier BPA Field Inspector BPA NOC Verifier FireNoc Approver Airport Authority Approver | FieldEmployee | Demo@123 | Alameda | 6000000002 |
Common Role for Employees Property Tax Counter Employee TL Approver Counter Employee BPA Services Approver BPAREG doc verifier BPAREG Approver | OfficeEmployee | Demo@123 | Alameda | 6000000003 |
Common Role for Employees State Administrator | Administrator | Demo@123 | Alameda | 6000000004 |
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
Add Role-Action mapping for the APIs in MDMS. Following are the required entries.
MDMS Actions & Role Action Mapping for TL
displayName | Roles |
---|---|
/tl-services/v1/_create | EMPLOYEE,CITIZEN,TL_APPROVER,TL_CEMP |
/tl-services/v1/_update | EMPLOYEE,CITIZEN,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR,TL_APPROVER,TL_CEMP |
/tl-services/v1/_search | EMPLOYEE,CITIZEN,TL_APPROVER,TL_CEMP,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR |
/collection-services/payments/_create | TL_CEMP,SUPERUSER,EMPLOYEE |
/inbox/v1/_search | TL_CEMP,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR,TL_APPROVER,AIRPORT_AUTHORITY_APPROVER |
2. TL Calculator Service
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
Add Role-Action mapping for the API’s in MDMS. Following are the required entries.
MDMS Actions & Role Action Mapping for TL
displayName | Roles |
---|---|
/tl-calculator/billingslab/_search | SUPERUSER,EMPLOYEE,TL_APPROVER,TL_CEMP,CITIZEN,TL_DOC_VERIFIER,TL_FIELD_INSPECTOR |
/tl-calculator/billingslab/_create | SUPERUSER |
/tl-calculator/billingslab/_update | SUPERUSER |
tl-calculator/v1/_getbill | EMPLOYEE,TL_APPROVER,TL_CEMP,CITIZEN |
/tl-calculator/v1/_calculate | SUPERUSER |
3. PT Service
Actions & Role Action Mapping
Add Role-Action mapping for the API’s in MDMS. Following are the required entries.
MDMS Actions & Role Action Mapping for PT
displayName | Roles |
---|---|
/property-services/property/_search | CITIZEN,PT_CEMP,PT_DOC_VERIFIER,PT_FIELD_INSPECTOR,PT_APPROVER,TL_CEMP |
/property-services/property/_create | CITIZEN,PT_CEMP,TL_CEMP |
/property-services/property/_update | CITIZEN,PT_CEMP,PT_DOC_VERIFIER,PT_FIELD_INSPECTOR,PT_APPROVER,TL_CEMP |
/pt-calculator-v2/propertytax/v2/_estimate | PT_CEMP,CITIZEN,TL_CEMP |
/property-services/assessment/_create | SUPERUSER,PT_CEMP,CITIZEN,TL_CEMP,CITIZEN |
/property-services/assessment/_search | TL_CEMP,SUPERUSER,PT_CEMP,CITIZEN |
Referral Docs
Bugs Found In TL
Ticket reference | Issue | RCA |
---|---|---|
ISNE-378 | TL: Create new application issue when user selects TL owner details from PT | |
ISNE-366 | TL: Accessory category options not displayed in UI | Accessory category needs to be added to TL billing slab Property type and Ownership category are required to be having a dot separated value in mdms |
ISNE-392 | TL: Pop up message to be displayed when user clicks on payment button | Localization updated |
ISNE-393 | TL: Financial Year hard coded for TL renewal Need to make it dynamic based on current TL validity period | |
ISNE-389 | TL employee randomly gets navigated to citizen login screen |
Last updated