Tenant Signup and First Login Journey
The authoritative developer guide for the full Shumoul tenant self-service signup flow — from the public reference-data lookups a signup form calls before submission, through registration, account activation, first login, the first-login onboarding survey, settings recommendation/apply, and the conditions that make the tenant's dashboard reachable.
This chapter set was written to close a specific production defect: public tenant self-registration was
failing with "Shared location reference-data validation is not implemented in this codebase." — see
Chapter 6 — Location Validation for the root cause and fix, and
Chapter 13 — Troubleshooting for the exact error text and how to recognize it.
Who it's for: Backend Developers · Frontend/Angular Developers (Shumoul.Portal) · QA · DevOps · Future Maintainers
| Field | Value |
|---|---|
| Status | Production Ready (backend) — documents the self-service signup contract for the frontend team |
| Version | Shumoul.Framework.MultiTenancy.Api 1.0.116 |
| Last Updated | 2026-07-19 |
| Maintained By | Shumoul Engineering |
| Documentation | Official Developer Guide |
| Source of Truth | Shumoul Platform Source Code (Shumoul.Saas.MultiTenancyApi, Shumoul.Saas.Api) |
Related chapters in other guides
This guide documents the signup → first login boundary specifically. Once a tenant's admin has logged in for the first time, the onboarding survey → recommendation → apply → Starter Kit flow is already documented in full elsewhere — this guide cross-references rather than duplicates it:
- Business Onboarding & Smart Configuration — the survey, recommendation engine, settings patch, and internal apply bridge.
- Tenant Starter Kit & Product Catalog — the separate, admin-only Preview/Apply orchestration that provisions a tenant's chart of accounts, inventory account categories, cost centers, and starter product catalog.