7. Owners & investors
The terminal step. You’ll see two cards:
- Equity Owners — legal shareholders with ownership percentages.
- Investment Participation Agreements — per-investor capital tranches with profit-split terms.
Together they describe who owns the business and how profits flow.
Card 1 — Equity Owners
Section titled “Card 1 — Equity Owners”Add one row per legal owner. Each row needs:
- Name (auto-creates a counterparty if it doesn’t exist).
- Equity % > 0.
- Profit-share % — defaults to equity %. Toggle “Advanced: profit-share differs from equity” to set them independently.
Equity percentages must sum to exactly 100 (within 0.01 tolerance). The footer shows a live Σ = X.XX% badge — emerald when balanced, rose otherwise.
Card 2 — Investment Participation Agreements
Section titled “Card 2 — Investment Participation Agreements”Add one row per agreement (investors can have multiple agreements):
- Investor name — pick existing or add new via the ”+ Add new investor” sticky option.
- Agreement type — Equity investment or Mudaraba (Islamic-finance profit-sharing).
- Capital amount + currency.
- Investor profit % + Owners profit % (must sum to 100).
- Unpaid profit at cutover (optional) — declared but unpaid profit you owe the investor as of conversion date.
What happens when you click “Finalize migration”
Section titled “What happens when you click “Finalize migration””Finalizing runs in order:
-
Mudaraba reclass — for each Mudaraba agreement, its capital moves out of the Opening Balance Equity bucket and into that investor’s capital-payable balance.
-
Unpaid profit accrual — for each agreement with
unpaidProfitAtCutover > 0, that unpaid amount also moves out of Opening Balance Equity into that investor’s profit-payable balance. -
Validate remaining OBE ≥ 0. If Mudaraba capital plus unpaid profit exceeds what’s left in Opening Balance Equity, the wizard rejects with
MUDARABA_EXCEEDS_OBE. Reduce Mudaraba capital or post more opening balances. -
Equity allocation — the remaining Opening Balance Equity is split across the equity owners in Card 1, by their equity percentage. Last owner row absorbs any rounding residual, becoming that owner’s capital.
After Finalize, the Opening Balance Equity bucket should be zero. You’re live.
Going live
Section titled “Going live”Open /chart-of-accounts and confirm:
- Opening Balance Equity = 0
- Owner’s Capital totals the equity portion
- Investor Capital Payable totals Mudaraba capital
- Investor Profit Payable totals unpaid profit
You can now start adding cars, issuing invoices, and recording payments on top of the migrated foundation. The Audit & troubleshooting page covers post-cutover edits if you need to fix something.
Related
Section titled “Related”- Opening balance equity
- Owners & distributions — runtime equity changes + distributions
- Step 6: Verify OBE