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.
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
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
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
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
FEE_SIMPLE_OWNERSHIP
Fee Simple Ownership
LEASEHOLD_OWNERSHIP
Leasehold Ownership
TENANCY_IN_COMMON_(TIC)
Tenancy in Common (TIC)
Boundary
ALM001
East End, West End
ALM002
Albany Hill, East Albany
ALM003
North Berkeley, South Berkeley
Owner Type
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
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
HRMS, Superuser
HRMSSU1
Demo@123
Alameda
9999009902
Superuser
SUPERSU
eGov@123
California
9999009900
Citizen
6100000010
123456
Architect
6109981231
123456
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
/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
/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
/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
ISNE-378
TL: Create new application issue when user selects TL owner details from PT
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. https://github.com/egovernments/egov-mdms-data/commit/51a50852dd4a312aaea8c1b824864fd7bc7f0c47 https://github.com/egovernments/egov-mdms-data/commit/dc8930811e28f0042b7694bf466870929cd5b483
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
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. https://github.com/egovernments/DIGIT-Dev/commit/0971443040d2c192816165a93629f8df93489335
ISNE-389
TL employee randomly gets navigated to citizen login screen
Removed working of isCreateEnabledEmployee variable because it was redirecting to another url without any reason. https://github.com/egovernments/DIGIT-Dev/commit/85bf283f163d0b19e8b981662fe5a8af09ab22b7
Last updated