Team → Roles (permissions) · Property Sales → /property-sales (the work)
A property sale passes through several hands. This page describes each person: what they see, where they work, and what lets them act.
The three permissions
Property Sales adds three permissions. There are no built-in sales roles: your administrators make roles from these permissions on the Roles screen, so they fit however your team is organised.
| Permission | Lets a person | Typical holder |
|---|---|---|
| View property sales | See the command centre, availability board, enquiries, deals, setup, agents and commissions. | Everyone on the sales team, finance, directors |
| Sell property sales | Work a sale: create and update enquiries, log activities, hold or reserve a unit, make offers, record a signature, send statements, run the handover checklist. Only on their own enquiries and deals. | Sales representatives and managers |
| Manage property sales | Run the development: stock, prices and sales rules, release or withhold units; approve discounts; extend deadlines; change a signed plan; cancel a sale; hand over keys; register agents and approve commissions. Act on anyone's deal. | Sales managers |
A sales representative role is usually View + Sell. A sales manager role is View + Sell + Manage. The Admin and Account Owner roles hold all three.
Two more conditions apply:
- Nyumba Zetu switches Property Sales on for each organisation. Until it is on, nobody in the organisation sees the Property Sales section.
- Visibility covers the whole organisation. Anyone with View sees every development's enquiries and deals. Ownership decides who can change them, not who can see them.
Developer or administrator
The developer's own administrators set the module up and keep it in shape.
- Screens: Setup (developments, phases, layouts, units, price lists, sales rules, listing photos) and the Roles screen.
- Can: everything a sales manager can, because the Admin and Account Owner roles hold all three permissions.
- Decides: who sells which development. A person counts as a representative of a development when they hold Sell and have access to that development's property, or to the whole organisation. There is no separate assignment screen: property access and role do it.
Sales manager
- Screens: Sales command centre, Setup, Availability, Enquiries, Deals, Approvals, Agents, Commissions.
- Can, beyond a representative:
- set up stock and prices, and release or withhold units;
- approve or decline a discount a representative asked for;
- make an offer above the discount limit, with a reason;
- extend a hold, reservation or offer deadline once;
- change the payment plan of a signed sale;
- cancel a sale that has been paid on or signed;
- hand over the keys;
- register agents, set commission schemes, approve commission parts and settle credit disputes;
- reassign any enquiry and act on any deal.
- Is told about: discounts waiting for approval, and deadlines that passed but were kept because money was received, the agreement was signed or a discount is waiting. These arrive as in-app notices. Everything waiting on a decision is listed on Approvals, and Team activity shows what each salesperson has logged.
Sales representative
- Screens: Availability, Enquiries, the person page, Deals, the deal page.
- Can:
- record enquiries and log calls, messages, visits and notes;
- book viewings and raise follow-up tasks;
- hold or reserve an available unit and record the reservation fee;
- make an offer within the development's discount limit, or ask a manager for a bigger discount;
- issue the offer letter, record the signed agreement, send statements;
- add documents and tick handover checklist steps;
- release their own unpaid hold or reservation, and add people to a unit's waiting list.
- Cannot: extend deadlines, cancel a sale, change a signed plan, hand over keys, touch setup or approve anything.
- Is told about: a deadline on their deal ending within 24 hours; a decision on their discount request; a unit freed and held for a person on their waiting list; a new enquiry from outside assigned to them. Follow-up tasks are emailed to them when they are created, and each morning they get a reminder of follow-ups due or overdue.
External agent or agency
An agent is a person or agency on your agent register, linked to the developments they may sell. Agents never get a staff login: they use the agent portal, once staff invite them from the agent page.
- Can: see the available stock of their developments with today's prices, register a client, hold an available unit for one of their own clients, follow their deals and see their commission parts and statement.
- Cannot: see other agents' clients, see who holds or bought a unit, reserve, offer or approve anything.
- Protected: a client an agent registers stays credited to that agent for the development's lead-protection period, 60 days by default.
Staff representatives can also be put on the agent register so they earn commission. They do not get the agent portal.
Buyer
A buyer is a person named on a deal. From reservation onwards each buyer, including each joint buyer, can use the buyer portal.
- Sees: their home, balance, next payment, payment schedule, statement, construction updates, the signed agreement and the offer letter.
- Can: pay an invoice by M-Pesa from their phone, and download their statement as a PDF.
- Gets access: when staff invite them from the deal or person page.
- Signs in: with a link and a six-digit code sent by SMS or email. There is no password.
- Loses access: when the deal is closed.
Finance
Property Sales has no finance role of its own. Finance works with the permissions they already have.
| Task | Where | What it needs |
|---|---|---|
| Record a buyer's payment | Deal page → Record payment | Permission to create payments |
| Match paybill and bank payments | Payments, automatically | Automatic reconciliation on for the branch |
| Refund a cancelled sale | Payments → Refunds | Permission to refund payments |
| Start an agent payout run | Agent page → Payout run | Permission to create payout runs; approval and disbursement as for any run |
| Read the sale's accounts | Accounting reports | As for any report |
Instalment invoices are raised automatically. There is no "raise invoice" button for a sale.
Nyumba Zetu, the system
Five scheduled jobs and a set of in-app notices do the work nobody should have to remember.
| Job | How often | What it does |
|---|---|---|
| Deadline check | Every 5 minutes | Lapses a hold, reservation or offer past its deadline, unless money was received, the agreement signed or a discount is waiting; frees the unit for the waiting list; warns the owner 24 hours before. |
| Instalment invoicing | Once a day | Invoices each instalment on its date, voids the unpaid bills of deals that ended, settles cancellation forfeits. |
| Commission check | Every 15 minutes | Creates commissions from reservation, marks parts earned, posts approved parts and settles closed deals. |
| Due reminders | Every morning at 08:00 | Reminds each person of their follow-ups and next actions due that day or overdue. |
| Monthly statements | On the 1st of each month | Sends every buyer of a sale still going their statement, for developments that choose it. |
Handoffs, tasks and notifications lists every notice.