# Agents — from sign-up to getting paid

## The journey
1. **Sign-up** — the agent creates a login (public sign-up, if open) and confirms their e-mail. Sign-up never asks about fees.
2. **Application** (their screen "My application", #/onboarding) — business details, VAT number, the roles they want (Product owner, Seller, Package builder, Introducer), required documents, and signing the agreement (Partner Pack). Saves as they go.
3. **Our checks** (Accounts → New agent applications, #/partners) — documents accepted and in date, e-mail proven, agreement sent and signed, required checks done. Approval is refused until all are complete.
4. **The deal desk** (Accounts → Agents, #/desk) — every agent moves through stages: New sign-up → Contacted → Negotiating → **Agreed** (or On hold / Declined). Log every contact.
5. **The deal** (open the agent → Deal) — the ONLY place their terms live. Every term must be filled in:
   - our service fee per sector (flights, stays, cars, coaches, their packages, their own products) — % or fixed R per booking
   - their live margins per sector for the sites they run — % or R
   - seller share (when they sell someone else's product) and introducer share + months
   - monthly platform fee (0 allowed)
   - who carries the gateway fees: the customer (card fee), the agent, or us
   The system refuses an incomplete deal and refuses a deal under which any kind of sale would lose money. A deal applies from its start date, never inside a month already on their statement. New versions keep history.
6. **Trading** — an agent can sell only when: application approved + login not suspended + a complete deal agreed. Before that, their packages and links sell nothing.

## What agents do
- Load packages (Packages → New package → wizard → Send for approval). An admin approves them onto sites the agent may use.
- Share tracked links and the booking widget (My links & widget). A booking through their link is theirs — the tracked link wins over the site it was made on.
- Run a site with us (My site) — live sales there are priced with the margins in their deal.
- Send quotes (Quotes) — a branded quote page; the client pays by card on it before booking.
- Look after corporate clients (My corporate clients).

## How agents earn
- Their own packages: the sale less net cost and our service fee.
- Live sales on their sites: their margin less our service fee.
- Selling another agent's product: their seller share of our fee.
- Introducer: a share of our fee on every booking of a lodge/operator they brought in, for the agreed months.
- Earned on TRAVEL: a cancelled booking earns nothing and anything counted is reversed.
- VAT-registered agents get their commission with VAT on top (we need their tax invoice to claim it).

## Statements and payouts
- Monthly, after the month ends: statement ST-YYYYMM-id. More fees than earnings → carried forward.
- The agent may query within 30 days; we answer on the statement; then it is marked paid with the EFT reference and closed.
- Payout bank details change only with their password; they are e-mailed when it happens; a payout is held while their application is being re-verified.

## Monthly fees
- Charged only to agents who can trade, from the month their deal was agreed. A paused agent pays nothing for the paused months.

## Tiers (Agent programme → Tiers, currently OFF)
- **While off (now, and for phase 1): tiers take no part in any fee, commission, monthly fee, profit, report or recon.** Every agent is charged and paid only on the figures written in their own agreed deal; a figure missing from a deal is "not set" and that agent cannot trade. The starting tier's table is only the template a new deal's form is filled from — staff check every figure before saving. Never present a tier as an incentive or a lower fee.
- Bronze / Silver / Gold / Diamond by monthly turnover (Silver start, Gold R1m, Diamond R5m a month). A tier only shows what we offer at that level; a better rate applies from the date it is written into the deal. Switched off: nobody moves and agents do not see the ladder.

## Pausing, suspending, leaving
- On hold / paused: packages off sale, no monthly fee.
- Suspended login: cannot sign in or sell.
- An agent with sales is never deleted — history stays (statements, invoices) for at least 5 years.
- Changing key details (bank, business, VAT) triggers re-verification: checks touched are cleared and packages taken off sale until re-approved.

## Demo agents in the test data
- "Bushveld Tours & Travel" (Pieter) — agreed deal, runs travel19, packages PKG-DEMO…; Lindiwe — a new sign-up; "heinieagent" — the owner's real test agent (leave it).
