Organizations & Legal Entity Convergence
Manage any company workspace at rivenai.io/org — keeping your customer-facing brand display name distinct from your registered legal entity, FEIN, and Secretary of State filing while converging Auth, Riven Comms, Riven ERP, and Document Center.
Why workspace display name and legal entity are separate#
Real businesses frequently operate under a trade or brand name while contracting, banking, and filing taxes under a distinct statutory LLC, PLLC, or corporation. Riven models both fields natively for every organization so you never have to choose between clean workspace branding and accurate legal accounting.
| Field | Where it appears | Example |
|---|---|---|
| Workspace Display Name | App switcher, Riven Chat context, Riven Comms team title, portal header | VilleRetreats TM or PES Supply |
| Registered Legal Entity | Riven ERP res.company.name, POs/invoices, W-9 schedules, contracts | VILLERETREATSTM LLC or Portlandia Electric Supply LLC |
| Federal Tax ID (FEIN) | Riven ERP res.company.vat, 1099/W-9 schedules, tax-exemption packets | 87-4340012 |
| State / SOS Registration | Riven ERP l10n_us_state_identifier, corporate entity schedules | KY #1179078 |
Four-surface live convergence#
Whenever an organization owner or admin creates a workspace at /org, completes a Business Suite wizard, or clicks Save & Sync Surfaces inside /org/{id}, Riven converges four operational surfaces in a single transaction:
- Riven Auth & OIDC SSO — updates the canonical organization profile, custom data (
legalEntity,taxId,jurisdiction), and optional Entra ID / SAML / SCIM directory bindings. - Riven Comms & 5 Department Desks — provisions or updates the dedicated team (
t-{slug}) and refreshes channel headers across all 5 standard Department Desks (Operations,Sales & Intake,Finance & Billing,Support & Fulfillment, andExecutive). - Company-Isolated Riven ERP 0.0.06+e — binds and updates the tenant’s isolated
res.companyrecord (name,vat, andl10n_us_state_identifier) with strict multi-company ACLs (company_id+company_ids). - Document Center & Compliance Vault — links
/org/{id}/documentsso corporate formation filings and FEIN / W-9 schedules verify against the active legal identity and sync to Riven ERP.
Step-by-step: updating or disambiguating an entity#
- Open rivenai.io/org and select your organization (or create a new organization with Legal Entity & FEIN expanded).
- In Organization & Legal Entity Identity, enter the Workspace display name, Registered legal entity name, Tax ID / FEIN, and State / SOS registration.
- Click Save (or Sync all surfaces) and verify all four status badges under Connected Surfaces & Live Convergence show green (
Active,5/5 Desks,Company #{id}, andDocs · ERP Synced). - Open Document Center in the left rail (or
/org/{id}/documents) and click Generate Entity & W-9 Packet to mint updated schedules into Riven ERP.
All Riven ERP identity and document sync operations execute with mail_notrack and tracking_disable, ensuring zero unsolicited notification emails are ever sent to external partners or customers during admin updates.