Go to App
← Back to Documentation

Branch Management

Manage multiple business locations with hierarchical organization structure. Each branch can have its own compliance obligations, SSL domains, and notification routes.

Organization Hierarchy

Tenant (Organization)
Head Office
Branch A
Branch B

Branch Properties

FieldTypeDescription
codestringUnique branch code (e.g., HQ-001, BR-DHK-01)
namestringDisplay name of the branch
addressLinetextFull street address
cityCorporationstringCity corporation (e.g., Dhaka North, Chattogram)
districtstringDistrict name for jurisdiction rules
regionstringRegion/division
countryCodestringISO country code (default: BD)
statusenumactive, inactive, archived

Jurisdiction Support

Branches are linked to jurisdictions for applying location-specific compliance templates. City corporations and districts determine which obligation templates apply.

SSL Domain Assignment

Domains can be assigned to specific branches for organized SSL monitoring. Each branch can have multiple associated domains.

User Assignment

Users can be associated with branches through roles. Branch Managers see only their assigned branches, while Head Office Admins see all.

Branch-Specific Routes

Notification routes can be configured per branch, allowing different alert destinations for different locations.

API Endpoints

GET/api/branches

List all branches for the current tenant

POST/api/branches

Create a new branch

PATCH/api/branches/:id

Update branch details

DELETE/api/branches/:id

Delete a branch (cascades to related data)