Property Sales user journeys

Six journeys through Property Sales, start to finish. Set up a development, take an enquiry to a reservation, turn a reservation into a signed sale, collect an instalment, sell through an agent, and let a reservation lapse or cancel a sale.

Property Sales → /property-sales

The other Property Sales guides describe one screen or one rule at a time. This page follows the work instead. Each journey below is one piece of the job, done from start to finish by the people who do it. At every step it says who acts, what they do, and what Nyumba Zetu does in response.

#JourneyPeople
1Set up a development for saleSales manager
2From enquiry to reserved unitBuyer, representative
3From reservation to signed saleRepresentative, sales manager, buyer
4A buyer pays an instalmentBuyer, finance
5An external agent sells a unitAgent, sales manager, finance
6A reservation lapses, and a sale is cancelledSystem, sales manager, finance
SellingContract and moneySetupdevelopment, units, pricesEnquiryrecorded, auto-assignedFollow-upcalls, viewings, tasksHoldunit held, no feeReservationfee invoicedOfferprice and payment planAgreement signedrecorded on the dealSoldsigned + deposit paidInstalmentsinvoiced and receiptedHandoverkeys; revenue recognised
A property sale from setup to handover. Green steps happen on their own; the rest are a person's action.

1. Set up a development for sale

Wanjiru Kamau, the sales manager, sets up Kilele Heights once: its unit types, its units, their prices and the rules they sell under. When she is done, the units appear on the availability board, ready for her team to sell.

Design board for journey 1: five screens side by side: define unit types, generate the units, set the price list, set the sales rules, and release Phase 1. Under each screen it says who acts, what they do and what the system does.
Journey 1 in the design: Wanjiru sets up Kilele Heights, from unit types to releasing Phase 1.
  1. Describe each unit type once

    • Who: Sales manager, in Setup.
    • Does: Adds each repeated layout, such as 2 Bedroom Garden, with its bedrooms, size and base price.
    • Nyumba Zetu: Uses the type as the starting point for every unit built from it. Setup is done by type, never unit by unit.
  2. Generate the units

    • Who: Sales manager.
    • Does: Generates units by block and floor, or uploads a spreadsheet for an irregular building.
    • Nyumba Zetu: Creates every unit with its number and type in one step. Each new unit is Not released: it exists, but it is not on sale yet.
  3. Set the sales rules

    • Who: Sales manager.
    • Does: Sets the hold, reservation and offer lengths, the maximum discount, the lead-protection period and the commission scheme.
    • Nyumba Zetu: Applies these rules to deals in this development only, so another project can sell on different terms.
  4. Publish a price list

    • Who: Sales manager.
    • Does: Fills a price list from the type prices, adjusts where needed and publishes it.
    • Nyumba Zetu: Stores the list with its date. A later list changes new deals only: every deal keeps the price it was offered at.
  5. Release the first phase

    • Who: Sales manager.
    • Does: Releases Phase 1 and keeps Phase 2 back.
    • Nyumba Zetu: Turns the phase's units from Not released to Available on the board. From here a unit's status comes from its live deal. Nobody sets it by hand.

Full detail: Developments, units and prices.

2. From enquiry to reserved unit

Grace Wambui fills in the enquiry form on Kilele Heights's listing page. Achieng Odhiambo, a sales representative, takes her from that enquiry to a reserved three-bedroom unit, without typing her details in again.

Design board for journey 2: Grace Wambui's enquiry arrives, the representative logs a call and books a viewing, records the viewing outcome, holds unit B-0304 and records the reservation fee. Under each screen it says who acts, what they do and what the system does.
Journey 2 in the design: Grace's enquiry becomes a reservation of B-0304.
  1. The enquiry arrives

    • Who: Grace, on the listing page. Then the representative.
    • Does: Grace gives her name, phone number and the kind of home she wants.
    • Nyumba Zetu: Looks for Grace by phone, then by email, so one person never has two records. Gives the enquiry to the next representative in turn, Achieng, and sends her an in-app notice, New enquiry for Kilele Heights. If nobody acts within the untouched-enquiry time (24 hours by default), the enquiry is flagged as Untouched.
  2. Call and book a viewing

    • Who: Representative, from Grace's person page.
    • Does: Logs the call, then books a site visit for Saturday with a next action and a due date.
    • Nyumba Zetu: Logging the call moves the enquiry from New to Contacted. The booked visit is a viewing; it moves the enquiry to Viewing once its outcome is recorded.
  3. Record the viewing and find units that fit

    • Who: Representative.
    • Does: Records that Grace came, and what she wants and can spend.
    • Nyumba Zetu: Lists the available units that match her bedrooms and budget on her person page. Grace chooses B-0304.
  4. Hold the unit

    • Who: Representative, from the board or the enquiry.
    • Does: Holds B-0304 for Grace.
    • Nyumba Zetu: Turns the enquiry into a deal and marks the enquiry Converted. B-0304 shows On hold to everyone, and nobody else can hold, reserve or sell it. The hold lasts 48 hours by default, and Achieng gets a warning 24 hours before it ends.
  5. Reserve it with a fee

    • Who: Representative.
    • Does: Reserves the unit and enters Grace's reservation fee of KES 200,000.00.
    • Nyumba Zetu: Moves the same deal from Hold to Reservation, with 14 days on the clock by default. The fee is invoiced at once and counts towards the price. Grace pays it by M-Pesa or bank to the sale's P reference, and the payment is matched to the bill automatically. Once any money is on the deal, it can no longer lapse quietly: at the deadline it goes to a manager.

Full detail: Enquiries and lead assignment.

3. From reservation to signed sale

Achieng, the representative, and Wanjiru, the sales manager, turn Grace's reservation into a signed sale, with a dated payment plan she can follow.

Design board for journey 3: preparing the offer with a discount above the limit, the manager approving the discount, issuing the offer letter, the signed agreement and deposit, and the payment plan with commission. Under each screen it says who acts, what they do and what the system does.
Journey 3 in the design: Grace's reservation becomes a signed sale with a payment plan.
  1. Prepare the offer

    • Who: Representative.
    • Does: Opens Make offer, enters the agreed price and builds the payment plan: the reservation fee, a deposit and monthly instalments. Grace has asked for a discount of KES 500,000.00, which is above the development's limit, so Achieng uses Request discount and gives a reason.
    • Nyumba Zetu: Checks that the fee and the instalments add up to the agreed price, to the cent. Because the discount is above the limit, nothing is offered or invoiced yet. Every sales manager except Achieng gets Discount waiting for approval. While the request waits, the reservation cannot lapse.
  2. The manager approves the discount

    • Who: Sales manager, from Approvals.
    • Does: Opens the deal, reads the reason and approves it.
    • Nyumba Zetu: Makes the offer exactly as requested and records Wanjiru as the approver. Achieng gets Discount approved. Nobody can approve their own request.
  3. Issue the offer letter

    • Who: Representative.
    • Does: Selects Issue offer letter.
    • Nyumba Zetu: Creates a numbered PDF with the agreed price, the plan and an "open until" date, files it on the deal and emails it to Grace. The unit shows Under offer for 30 days by default.
  4. Agreement signed, deposit paid

    • Who: Representative records the signature. Grace pays the deposit.
    • Does: Achieng uses Record signed agreement with the date Grace signed. Grace pays the deposit to the P reference.
    • Nyumba Zetu: Moves the deal to Sold by itself the moment both are true: the agreement is signed, and the fee and every deposit instalment are paid in full. A Sold deal has no deadline.
  5. Schedule and commission

    • Who: Nobody types the schedule.
    • Does: Achieng sends Grace a statement from the deal.
    • Nyumba Zetu: Invoices each instalment on its due date. If an agent is credited, the commission check moves the first part of their commission from Pending to Earned once its conditions are met. A manager then approves it.

Full detail: Reservations, offers and the deal lifecycle.

4. A buyer pays an instalment

An instalment on Grace's plan falls due. She pays it, and Mercy Chebet in finance sees it on the deal without entering anything.

Design board for journey 4: a reminder arrives, Grace opens her buyer portal, chooses how to pay, gets a receipt applied at once, and finance sees it applied on the deal. Under each screen it says who acts, what they do and what the system does.
Journey 4 in the design: Grace pays an instalment from her phone, and finance sees it applied.
  1. The instalment is invoiced

    • Who: Nyumba Zetu.
    • Does: Nobody in the sales office acts.
    • Nyumba Zetu: The daily invoicing job raises the instalment's bill on its due date (or the agreed number of days before). If the development sends monthly statements, Grace receives one on the 1st.
  2. Grace checks her buyer portal

    • Who: Buyer, on her phone.
    • Does: Signs in with a link and a six-digit code, with no password.
    • Nyumba Zetu: Shows her home, what she has paid and owes, the next payment and the sale's payment reference. The portal reads the same deal the staff see, so the figures always match.
  3. Grace pays

    • Who: Buyer.
    • Does: Pays the bill from the portal, which sends an M-Pesa prompt to her phone. She could also pay to the paybill or bank account with the P reference.
    • Nyumba Zetu: Matches the payment to the sale by its reference, when automatic reconciliation is on for the branch, and applies it to the sale's bills.
  4. Finance sees it applied

    • Who: Finance.
    • Does: Opens the deal page. There is nothing to type.
    • Nyumba Zetu: Shows each instalment's amount, what was invoiced, what was paid and the balance, with the recent receipts. Money that no bill has taken yet shows as Buyer credit, ready to apply.

Full detail: Payment plans, receipts and accounting and Buyer and agent portals.

5. An external agent sells a unit

Faith Njeri, an agent with Pwani Realty, brings her client Daniel Mutua to Kilele Heights and follows her commission from her phone until it is paid.

Design board for journey 5: the agent portal's live stock, registering a client, holding a unit, following the deal to Sold, and the commission moving from Pending to Paid. Under each screen it says who acts, what they do and what the system does.
Journey 5 in the design: Faith sells a unit through the agent portal and follows her commission.
  1. See live stock

    • Who: Agent, in the agent portal.
    • Does: Checks which units are free before calling her client.
    • Nyumba Zetu: Shows only the developments Faith may sell, with today's prices and each unit's status. She never sees who holds or bought a unit, or another agent's clients.
  2. Register the client

    • Who: Agent.
    • Does: Registers Daniel with his name and phone number.
    • Nyumba Zetu: Creates the enquiry, gives it to the next representative in turn, and credits Daniel to Faith for the development's lead-protection period, 60 days by default. If another agent claims Daniel, the deal records a credit dispute for a sales manager to decide.
  3. Hold the unit

    • Who: Agent, after showing Daniel the unit.
    • Does: Holds the unit for Daniel from the agent portal.
    • Nyumba Zetu: The unit shows On hold to everyone for 48 hours by default. The representative carries the deal on from here: reservation, offer and agreement, as in journeys 2 and 3.
  4. Commission moves from Pending to Paid

    • Who: Nyumba Zetu, then the sales manager, then finance.
    • Does: Wanjiru approves each earned part. Mercy includes it in the agent's payout run.
    • Nyumba Zetu: Works out the commission when Daniel reserves, split into parts by the development's scheme. By default that is half when the agreement is signed and the deposit is paid, and half when 50% of the price is paid. The commission check moves each part to Earned when its conditions hold (it runs every 15 minutes). An approved part is posted to the accounts, and a paid payout run marks it Paid. Faith sees every part in the agent portal and can download a statement.

Full detail: Agents and commissions.

6. A reservation lapses, and a sale is cancelled

A unit comes back on sale in one of two ways. A deal with nothing on it lapses by itself, and the system needs no help. A deal with money or a signature on it must be cancelled by a manager, and finance settles the money.

Design board for journey 6: a warning 24 hours before a deadline and an unpaid reservation lapsing to the next person in line, then a manager cancelling a signed sale, the refund worked out, and the unit released with the money unwound. Under each screen it says who acts, what they do and what the system does.
Journey 6 in the design: a reservation lapses on its own, and a signed sale is cancelled.

A reservation lapses

  1. A warning, 24 hours before

    • Who: Nyumba Zetu, to the deal's owner.
    • Does: Achieng calls the buyer, who has not paid the fee and decides not to go ahead.
    • Nyumba Zetu: Sends an in-app notice 24 hours before every hold, reservation and offer deadline. A manager can extend a deadline once per stage, with a reason.
  2. It lapses, and the next person waiting is offered the unit

    • Who: Nyumba Zetu.
    • Does: Nobody releases the unit by hand.
    • Nyumba Zetu: With nothing paid, nothing signed and no discount waiting, the deal closes as Lapsed and its unpaid bills are cancelled. If someone is on the unit's waiting list, the unit is held for the first person in line, and whoever added them is told. That hold lapses like any other, and the unit then passes to the next person waiting.

A signed sale is cancelled

  1. The manager cancels the sale

    • Who: Sales manager, from the deal page.
    • Does: Selects Cancel sale and writes down why.
    • Nyumba Zetu: A deal with money or a signature on it never lapses, so only a manager can end it. The cancellation goes into the deal's history with who, when and why, and the unit returns to sale at once.
  2. The forfeit is worked out

    • Who: Nyumba Zetu.
    • Does: Nobody calculates anything by hand.
    • Nyumba Zetu: Applies the development's forfeit rule: the developer keeps a percentage of the price (with an optional minimum), never more than the buyer has paid. A forfeit bill is raised and paid from the buyer's receipts. Whatever is left stays as credit on those receipts, in Unapplied receipts (2240).
  3. Finance refunds the buyer

    • Who: Finance, told by the manager.
    • Does: Refunds the credit from Payments, receipt by receipt.
    • Nyumba Zetu: Refunds nothing by itself. The refund due is on the deal's history.
  4. Commission is unwound

    • Who: Nyumba Zetu.
    • Does: Nobody adjusts commission by hand.
    • Nyumba Zetu: Parts not yet paid are Reversed. A part already paid is Clawed back: it becomes an amount the agent owes, deducted from their next payout run.

Where to next

Frequently asked questions

What does a typical property sale look like in Nyumba Zetu?
An enquiry arrives and goes to the next representative in turn. The representative calls the buyer, books a viewing and holds a unit for 48 hours. A reservation fee turns the hold into a 14-day reservation, and the fee is invoiced at once. An offer with a payment plan follows, open for 30 days. The deal becomes Sold automatically once the agreement is signed and the deposit is paid. Instalments are invoiced as they fall due, and the keys are handed over once the sale is paid in full.
Does anyone have to release a unit by hand when a reservation is not paid?
No. A hold, reservation or offer with nothing paid, nothing signed and no discount waiting lapses by itself at its deadline, and the unit goes back on sale. If someone is on the unit's waiting list, it is held for the first person in line.
Who refunds a buyer when a sale is cancelled?
Finance. Cancelling works out the forfeit by the development's rule and keeps the rest as credit on the buyer's receipts. Finance then pays the refund from Payments. Nothing is refunded automatically.