# Our business at a glance (as at 15 Nov 2026)

## Who we are
- **API Travel Solutions** builds and runs the platform: the back office, the booking engine, the sites, the corporate bookers and the books. API supplies live travel content (flights, hotels, car hire, coaches) through its supplier connections.
- **Getaway (Getaway Travel)** is the partner brand. Getaway and API Travel Solutions together own the platform's income and split it by four agreed rules (see "The owners' split").
- One back office, one checkout, one set of books runs everything: our own sites, agents' sites, the corporate bookers.

## How money comes in (the channels)
1. **Direct sales on our sites** — guests book live flights, stays, cars, coaches, and our packages. We earn our margin.
2. **Our own packages** — packages Getaway/API load. We are the principal; the margin after net cost is shared 70 Getaway / 30 API.
3. **Agents** — travel agents, lodges and operators sign up, load their own packages and sell through their tracked links, the booking widget on their own website, or a site they run with us. Each agent is priced and paid ONLY on their own agreed deal. We earn our service fee per sector, plus margin share on live sales.
4. **Corporate clients** — companies book business travel in their own branded booker (their logo and colours) at `/<theirname>/` on our server (or their own domain). They pay the supplier price plus their own service fee per sector, sometimes a monthly fee.
5. **Monthly platform fees** — some agents and corporate clients pay a fixed monthly fee.

## The non-negotiables (decided by the owners)
- **Card payment before every booking**, on every channel. No on-account, no credit, no pay-later. A failed payment = no booking.
- **Nothing is sold at the supplier's price**: every sector needs a margin, every package a net cost, every deal must not lose money.
- **The books never change after the fact**: rates apply to new sales only; corrections are new records; nothing with sales is deleted.
- **One home per setting and per screen**: no two places set the same value; money screens live only in Finance.
- **Agents and corporates on their own terms**: Fees & margins only prices our own direct sales.

## The owners' split (Fees & margins → step 2)
What the platform keeps after suppliers, gateway fees, agents' shares and VAT is shared:
| Kind of sale | Getaway | API Travel Solutions |
|---|---|---|
| Live bookings (flights, hotels, cars, coaches, live add-ons in a package) | 50% | 50% |
| Packages Getaway/API loaded (whoever sells them) | 70% | 30% |
| Packages an agent loaded (what is left of our fee) | 50% | 50% |
| Monthly platform fees | = live rule (50%) | 50% |
Card money is paid into API Travel Solutions' account (Settings: card collector); API pays Getaway its share monthly (Finance → Platform → What we owe).

## What we sell
- **Live**: flights (local and international), hotels and stays, car hire, coaches — priced live from suppliers through API's connections, with our margin added (strict mode).
- **Packages**: multi-day trips with stays, activities, cars, add-on flights; per person or per group; seasons, discounts, child prices, single supplement, departures.
- **Agents' own products**: their stays, activities and events.
- Travel insurance is NOT sold (FAIS licence and accounting not in place).

## The people in the system
- **Admins** (our team) — see everything. Two-step sign-in is required for money actions after go-live.
- **Agents** — one login type; roles: Product owner (loads packages), Seller (sells via link/site), Package builder, Introducer (brings in lodges/operators and earns on their bookings for a number of months).
- **Corporate users** — inside their own booker: admin, travel manager, manager, supervisor, finance, traveller.
- **Guests / customers** — book on the sites; guest accounts with saved travellers.
- **Suppliers** — only the airlines, hotels, car-hire firms and coach lines we pay.

## Where it runs
- Development: this computer (localhost:8090 platform, :8091 corporate booker).
- Live hosting: Afrihost shared cPanel, `getaway.apitravelsolutions.com`, document root `getaway/public`. Updates go up as zips (code-only for live; full only for a fresh server).
- TravelClip (this assistant) runs only on the owner's computer for now.
