# 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**](https://docs.digit.org/local-governance/access/local-governance-stack/trade-license-tl)
2. [**Trade license master data templates**](https://docs.digit.org/local-governance/access/local-governance-stack/trade-license-tl/tl-master-data-templates)
3. [**Trade license calculator**](https://docs.digit.org/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>
