Property Sales roles and permissions

Who does what in a property sale, from developer and sales manager to rep, agent, buyer and finance, and the permissions and approvals that gate each one.

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.

PermissionLets a personTypical holder
View property salesSee the command centre, availability board, enquiries, deals, setup, agents and commissions.Everyone on the sales team, finance, directors
Sell property salesWork 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 salesRun 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.

TaskWhereWhat it needs
Record a buyer's paymentDeal page → Record paymentPermission to create payments
Match paybill and bank paymentsPayments, automaticallyAutomatic reconciliation on for the branch
Refund a cancelled salePayments → RefundsPermission to refund payments
Start an agent payout runAgent page → Payout runPermission to create payout runs; approval and disbursement as for any run
Read the sale's accountsAccounting reportsAs 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.

JobHow oftenWhat it does
Deadline checkEvery 5 minutesLapses 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 invoicingOnce a dayInvoices each instalment on its date, voids the unpaid bills of deals that ended, settles cancellation forfeits.
Commission checkEvery 15 minutesCreates commissions from reservation, marks parts earned, posts approved parts and settles closed deals.
Due remindersEvery morning at 08:00Reminds each person of their follow-ups and next actions due that day or overdue.
Monthly statementsOn the 1st of each monthSends every buyer of a sale still going their statement, for developments that choose it.

Handoffs, tasks and notifications lists every notice.

Frequently asked questions

Does Property Sales come with a Sales manager role?
No. Property Sales adds three permissions, View, Sell and Manage, and your administrators build roles from them on the Roles screen. A sales representative usually holds View and Sell; a sales manager holds all three.
Can a representative see other people's deals?
Yes. Anyone with View sees every development, enquiry and deal in the organisation. A representative can change only the enquiries and deals they own; changing someone else's needs Manage.
Can a manager approve their own discount?
A discount request can never be decided by the person who asked for it. A manager making an offer above the development's discount limit is allowed to do so directly and must give a reason, which is recorded on the deal as the approval.