How to read this manual
Every section follows the same five headings:
- Purpose — what this part of BMS is for.
- When to use it — the moment in the working week you open it.
- Step-by-step — exactly what to click and type.
- What happens next — where the information travels to.
- Rules & warnings — the business rules BMS enforces, and the traps to avoid.
This edition is illustrated — every screen is shown with a caption like this:
*Weekly Schedule — full week view*.
Words used in this manual
| Term | Meaning in Broomstix |
|---|---|
| HCP | Home Care Professional — a cleaner on the staff register. |
| Shift | One fixed working block (08:00–10:30, 11:00–13:30, 14:00–16:30). Wages are paid per shift, never per hour. |
| Clean / Visit / Job | One booked cleaning appointment at one property, in one shift. |
| Job card | The on-screen record of a single clean: rooms, team, sign-off, history. |
| Care Plan | The recurring service agreement for a property, from which cleans are generated. |
| Property A / Property B | The two property slots that can run at the same time in the same shift. |
| TL/QC | Team Leader / Quality Control — an HCP qualified to sign a job off. |
A note on two terms in your brief
- "Issued" — in BMS V1 an invoice that has been sent to the client carries the status Sent. Read "issued" as Sent throughout.
- "Completed With Exception" — BMS V1 does not have a separate status by that name. An exception is recorded as sign-off notes on the job card by the team leader (see 12. Quality control and exceptions). The status remains Completed; the note is the exception record.
Nothing in this manual describes a feature that is not in the finished V1 application.
1. Introduction to the Broomstix Management System
Purpose. BMS is the single operating system for a Broomstix cleaning franchise. It carries a client from the first phone call all the way to money in the bank and cleaners paid:
Enquiry → Quote (Home Assessment optional) → Care Plan → Cleans in the diary
→ Job card completed & signed off → Revenue earned
→ Invoice → Payment received
→ Shifts → Wages paid → ProfitWhen to use it. Every working day. It is not a filing system you update afterwards — the diary, the wages and the invoices are all built from what you capture as it happens.
Step-by-step (the shape of the system). The left-hand menu follows the business, top to bottom:
- Dashboard — Weekly Schedule, Schedule Job, Shift Availability, Month Calendar, To-Do Calendar
- Enquiries, Quotes, Clients & Properties, Care Plans, Assessments (optional)
- HCP Staff
- HCP Wages & Shifts, Payroll by Month, Closed Jobs
- Invoices, Payments, Client Accounts & Balances, Client Email List
- Monthly Revenue vs Wages, Finance & Profit per Week
- Operations Report
- Settings
*BMS main menu, full sidebar*
What happens next. Each screen feeds the next one automatically. You never retype a client name, a price or a shift count from one screen into another.
Rules & warnings.
- Broomstix works Monday to Friday only. BMS will not place a clean on a Saturday or Sunday.
- Two properties can run at once in one shift — Property A and Property B — no more.
- All money is in South African Rand.
3. Dashboard (Operations dashboard)
Purpose. Your morning picture: what is happening today, and what is stuck.
When to use it. First thing every morning, and again before you leave.
Step-by-step.
- Open Dashboard.
- Use the arrows beside the date to step backwards or forwards a day.
- Read the counters: Scheduled, In progress, Waiting final QC, Understaffed, Completed.
- Read the enquiry counters: New enquiries, Appointment booked, Assessed, Lost.
- Under Today's operations, search or scroll the day's visits and open any job card.
- Check the standing counters: Active clients, Active care plans, HCPs available, Assessments to do.
- Open Month Calendar for the whole month at a glance — each day lists its cleans, and a red flag marks a client whose payment is late.
*Operations dashboard — top counters and Today's operations*
What happens next. The dashboard is a window, not a form — you act from it by opening the job card, the schedule or the enquiry it points you to.
Rules & warnings. Understaffed means fewer cleaners are allocated than the clean requires. Fix it the same day on the Weekly Schedule; an understaffed clean will run short or fail.
5. Clients & Properties
Purpose. The property register: every client and every property Broomstix knows.
5.1 Adding a new client — one way
There is now one way to add a new client: the + New client button on Clients & Properties. It opens the same form as + New quote on the Quotes page, because a new client and their first price are captured together.
Step-by-step.
- Open Clients & Properties and press + New client.
- Fill in name, phone, email and address.
- Choose the kind and size of the property.
- Add the clean(s): type of clean, cleaners, shifts, price per clean, and a note such as *cleaning windows*. Use + Add a clean for a deep clean plus a regular clean.
- Save, then send the quote. The client is on the books immediately, and accepting the quote books the cleans into the diary.
Optional extras (not separate roads).
- Book a home visit (Assessments, section 6) when you want to measure the work before pricing. Saving it carries the details into the same quote form.
- Log an enquiry (Enquiries, section 4) when the client is still shopping around and you only want a record of the call. From the enquiry you send the quote with the same form.
- For an existing client, open their account (click the blue name) and press + New quote — details pre-filled.
Rules & warnings. Every route ends in one client record. If the name, phone or email matches an existing client, BMS warns you and offers *Use this existing client* — always accept it, so the history, invoices and statement stay together.
When to use it. To look someone up, check their history, or see who is still only a prospect.
Step-by-step.
- Open Clients & Properties.
- Click the counters at the top to filter: Active clients, Quoted, Prospects.
- Search the Property register and click the client's blue name to open their account. You can also find all balances under Client Accounts & Balances.
- On the client's account, use the Visits block to open every clean for this client — date, shift, type, address, amount, status and whether it is invoiced. Click any line to open its job card.
- Use Edit contact / address to change the client's name and surname, phone, email or property address. A name change follows through to their quotes, cleans and invoices.
- Scroll to the account statement to see total invoiced, paid, outstanding and overdue, with invoice and payment history. Use Email quote, Email invoice or Email statement at the top when needed.
*Clients & Properties — counters and property register*
*Client account — Visits expanded*
What happens next. A client appears after an assessment or direct quote, becomes Quoted when a quote exists and Active once a care plan is running. Contact and address corrections made here update the linked records.
Rules & warnings. BMS warns you when a new assessment looks like an existing client (matching name, phone digits or email) and offers *Use this existing client*. Always accept it — duplicate clients split the history, the invoices and the statement.
6. Home Assessment
Purpose. An optional aid for pricing the work and deciding the team when a home visit would be useful.
When to use it. After a site visit when you need room-by-room detail before quoting. For a straightforward enquiry, quote directly without an assessment.
Step-by-step.
- Open Assessments → new assessment (*Home Assessment & Workload*).
- Who owns this property? — choose the existing client, or capture a new owner.
- Property & visit — assessment date and time, property type, Estate / complex (dropdown, with *Other* for free text), address, client name, phone, email.
- Capture the preferred start date, cleaning frequency, whether the first clean is a deep clean, and whether Broomstix brings the cleaning products.
- Note pets, children, product notes and general notes.
- Work through the Room & task workload list. This is reference information only — it helps you judge the size of the job.
- In Team & shifts, set HCPs required and Shifts required yourself.
- Save the assessment.
*Home Assessment — Property & visit*
*Home Assessment — Team & shifts*
What happens next. The assessment appears in the Assessment Register (*Awaiting approval → Approved*), the client appears under Clients & Properties, and you can raise a Quote from it. The shift count you set here carries through to the care plan and to every clean generated from it.
Rules & warnings.
- The room list does not decide the team size — you do.
- Get Shifts required right. If a clean later shows fewer shifts than the assessment, BMS asks *"Is this a new, separate job?"* — answer No to restore the assessed shift count unless it genuinely is a different job.
- Sample assessments marked *demo only* are illustrations; they never reach the schedule.
7. Quotes
Purpose. The written price offered to the client. One quote can contain several different cleans.
When to use it. As soon as you know the kind and size of the property. A home assessment is optional.
Step-by-step.
- Open Quotes → + New quote. You can quote a new client directly, open it pre-filled from a client account, or raise it from an assessment.
- Confirm the client's name, email, phone, estate and address, then capture the property kind and size.
- In Cleaning requirements, write what the client needs — for example pets, children, bathrooms, allergies, busy rooms and how quickly dirt returns. Press Recommend frequency with AI.
- Read the suggested frequency and its plain-language reason. Press Use this frequency to apply it, or keep your own choice. This is advice only; franchise staff make the final decision.
- Add every clean included in the offer. Each clean has its own frequency, HCPs required, shifts, price and optional note (for example, *cleaning windows*).
- The register and quotation show a simple clean label — Once, Weekly, Twice weekly, Fortnightly or Monthly — so the type of clean is always clear.
- Set the preferred start date, valid until date and notes for the client, then save the draft.
- Before acceptance, use Edit details to correct the client's name, email, phone or address and to change the cleans on the quote.
- Use Review to check the quote, Quotation to print or save one quote, or Export PDF beside the client to print all their grouped quotes together. You can also email the quote.
- Use the status legend: Draft means not sent, Sent means awaiting an answer, Accepted means agreed and booked, and Declined means lost work. Hover over a status for the same explanation.
- When the client accepts, BMS asks you to choose a day and shift for each clean on the quote, then creates the care plans and diary visits.
7.1 A deep clean first, then a regular clean (different team sizes)
A very common agreement: the first visit is a once-off deep clean, and after that the client continues with a weekly, fortnightly or monthly clean. This is one quote with two cleans — do not create two quotes.
- Open Quotes → + New quote and capture the client as usual.
- Clean 1 is the deep clean: choose Once, set its own cleaners, shifts and price — for example 3 HCPs, 2 shifts, R1 100 — and add a note like *first deep clean*.
- Press + Add a clean for Clean 2: choose the regular frequency (Weekly, Fortnightly or Monthly) with its own team — for example 2 HCPs, 1 shift, R425.
- Choose the offered day and shift for each clean (the calendar shows what is free), then save, review and send.
What happens on acceptance. When the client accepts, BMS asks for a day and shift for each clean separately and creates two care plans: a once-off plan for the deep clean (3 cleaners) and a repeating plan for the regular clean (2 cleaners). Each clean keeps its own team size, shifts and price all the way to the invoice — the deep clean is billed once, the regular clean every month. For a clean that runs two shifts, you pick the day and the starting shift once — the next shift of that same day is booked with it, and the picker only offers days where both shifts have enough cleaners free.
Rules & warnings. Every clean on a quote has its own cleaners, shifts and price — never average them into one line, or the diary and wages will be wrong. Changing a clean's price in the quote editor updates the quote's own price, its totals and everything already booked from it, so they always stay in step. A single clean quoted on its own is labelled Once-off clean.
*Quotes — register and counters*
*Printable quotation document*
What happens next. Each clean on an Accepted quote becomes its own booked plan. Its agreed frequency, team size, shifts, price and notes carry into the work that follows.
Rules & warnings. Set Valid until — an expired price should be re-quoted, not honoured. Once a quote is accepted, this date is no longer relevant and is hidden in the register; the accepted price is locked in.
8. Creating a New Home Care Plan
Purpose. The care plan is the engine of the diary. It holds the agreement for one property and generates the recurring cleans.
When to use it. As soon as a quote is accepted and the client confirms a start date.
Step-by-step.
- Open Care Plans → New care plan (or create it from the accepted quote).
- Capture client name, phone, email, estate / complex, address, service type and frequency (weekly, fortnightly, monthly, once-off).
- Set the shift start time. For two cleans per week, set the first day of the week and its shift, and the second day and its shift.
- Set HCPs required, the shift count, and the team car.
- Set the effective date — the date the plan starts working from.
- Set price per clean and, if the first clean is a deep clean, the deep clean price and its shift count.
- Choose the Agreement state and capture scope / special notes.
- Save. BMS then generates the cleans forward into the diary.
- Open Agreement to print or save the client service agreement as a PDF for signature.
*New care plan dialog*
*Care Plans — Active plans table* Example — Client Service Agreement.
*Example Client Service Agreement — first part*
*Example Client Service Agreement — second part*
What happens next. Generated cleans appear on the Weekly Schedule as job cards, each carrying the plan's shift time, shift count, required HCPs and price. The plan is listed with Starts (effective date), Shifts, Next clean and how far it has been generated.
Rules & warnings.
- Cleans are generated on or after the effective date, on the chosen weekday(s) only, Monday to Friday.
- Changing the frequency or day mid-plan changes future cleans from the effective date forward — it does not rewrite history.
- Care plans are listed oldest effective date first.
- The price per clean on the plan is what gets invoiced. Correct it here, not on the invoice.
- Changing the type of clean in Edit care plan also changes the name that invoices and job cards show for that plan.
11. Scheduling jobs — putting a client on the calendar
There are three ways a client gets onto the calendar. Use the first that fits the situation.
11.1 By accepting a quote — the normal way for a new client
This is the easiest route, because the day and shift are agreed before the work is booked.
- Every clean on the quote already carries its offered day and shift (chosen on the quote, where the free/busy calendar shows what fits).
- When the client accepts, open the quote and press Client accepted. BMS asks you to confirm a day and shift for each clean on the quote — Clean 1, Clean 2, and so on.
- BMS then creates a care plan per clean and generates the cleans forward into the diary automatically. Nothing further to book.
The team, price, shifts and notes from the quote travel with the work — you never retype them.
11.2 By hand, with **Care Plans → New care plan** (repeating work without a quote)
Purpose. To start a repeating clean directly — for example a referral client who agreed everything over the phone.
Step-by-step. Open Care Plans → + New care plan, capture the client and property, choose the frequency, weekday(s) and shift, the team size, shift count, price and effective date, then save. BMS generates the cleans into the diary from the effective date — see section 8 for the full detail.
11.3 By hand, with **Schedule Job** (a single clean)
Purpose. To book one clean on one day — a spring clean, a deep clean, a favour, a move-out clean.
When to use it. Whenever the work does not repeat and therefore needs no care plan.
Step-by-step.
- Open the Weekly Schedule and click a cell marked AVAILABLE — the date, shift and property slot (A or B) are filled in for you. (You can also open Dashboard → Schedule Job and choose them yourself.)
- Job details — choose the client. For an existing client, BMS asks "Which clean?" and lists their cleans as *Clean 1, Clean 2, …*. Pick one and the price, shift count and number of cleaners fill in automatically from that clean. For a brand new client, capture the details and set these yourself.
- Under Team allocation, allocate the cleaners by name and choose the team leader.
- Save. One job card is created immediately.
*Schedule Job — job details and team allocation*
What happens next. The clean appears on the Weekly Schedule exactly like a care-plan clean, and follows the same road: complete → sign off → revenue → invoice.
Rules & warnings. One job fills one property slot in one fixed shift. If both slots are taken in that shift, choose another shift or another day. Schedule Job creates one clean — it never repeats. For repeating work, use 11.1 or 11.2 instead.
11.4 To-Do Calendar
Purpose. Your own reminders (call a client, order products, chase a signature) alongside the operational diary.
Step-by-step. Open Dashboard → To-Do Calendar, add the item with its due date and notes, and tick it complete when done.
*To-Do Calendar*
16. Invoices
Purpose. To turn completed cleans into invoices: normally one invoice per client per month, built from that month's visits.
When to use it. At month end, or at any point using Till today.
Step-by-step.
- Open Invoices.
- In Every finished clean, per client, each clean shows its date, shift, amount, whether it is invoiced, and the invoice reference where it is. The filters on top show All, Not invoiced or Invoiced cleans. Client totals carry summary pills for the number of cleans, Invoiced, Not invoiced and any overdue amount, and cleans booked for clients who pay in advance carry a Booked — can bill in advance pill.
- To bill selected cleans: tick them for one or several clients. Select all not invoiced ticks a client's cleans in one go, and Pick by day opens a small month calendar where one click ticks every unbilled clean on that day — including "can bill in advance" cleans; click the day again to untick it. The bar at the bottom shows your running total. Press Invoice selected cleans: BMS makes one Draft invoice per client, dated the day you make it. Cleans you did not tick stay ready for later.
- To bill everything ready in one go: press Invoice everything ready to bill above the list — it invoices every unbilled finished clean, one invoice per client, including booked cleans for clients who pay in advance.
- Use Undo invoicing to remove Draft invoices that have no payments yet and return those cleans to ready to bill.
- Scroll down to the Invoice register — every invoice sits there, drafts sorted to the top. Click the reference to open the printable TAX INVOICE document: logo, franchise details, reference, date, bill-to details, dated clean lines, subtotal, VAT, total, Nedbank payment details. Check it, add extras such as a cleaning material fee with Add a charge, then press Preview & send to email it, or Mark as sent once you have sent it yourself. You can also print it or save it as a PDF.
*Invoices — counters and Total per client*
*Every finished clean, per client — selection* Example — TAX INVOICE.
*Example printable TAX INVOICE, exactly as the client receives it*
What happens next. The invoice appears in the Invoice register, on the client's account and statement, in the client portal, and in Payments waiting for money.
Rules & warnings.
- Nothing bills itself. An invoice exists only because you ticked cleans and pressed the button.
- Only finished (signed-off) cleans can be invoiced. Open jobs are skipped.
- An invoice can be undone only while it is still a Draft with no payments — once it has been sent, or a payment is recorded on it, it stays.
- The amount comes from the care plan's price per clean (or deep clean price). Fix pricing on the plan.
- Extra charges, such as a cleaning material fee, are added to the individual invoice with Add a charge — they are never automatic.
Invoice statuses
| Status | Meaning |
|---|---|
| Draft | Created in BMS, not yet sent to the client. Can still be undone. |
| Sent ("Issued") | Sent to the client; the money is now expected. |
| Outstanding | Any amount still owing on a Sent invoice — including part-paid invoices. |
| Overdue | Outstanding past its due date. Chase it. |
| Paid | Payments received equal the invoice total. Nothing left owing. |
24. How information flows through BMS
24.1 The full life of one clean
- Enquiry logged — a name and a need. No money, no diary entry.
- Quote raised — directly from the enquiry, or after an optional Home Assessment; every quoted clean has its own frequency, HCPs, shifts, price and notes.
- Quote accepted — a day and shift is chosen for every clean on the quote.
- Care Plan created with an effective date, weekday(s), shift time, shift count and price. BMS generates the cleans into the diary.
- Weekly Schedule — the clean occupies Property A or B in a fixed shift; you confirm the team and the team leader.
- Job card worked — rooms ticked and the team leader signs the work off.
- Team leader signs off → status Completed. This is the switch. At that moment:
- Closed Jobs counts the amount as revenue earned;
- the clean appears in Invoices → Every finished clean, per client as ready to bill;
- its shifts count towards HCP Wages & Shifts.
- Wages paid — recorded on HCP Wages with the payment day; the cleaner's wage slip, portal and Payroll by Month reflect it.
- Invoice generated — status Draft. Still reversible with Undo invoicing.
- Invoice issued — status Sent. The amount is now Outstanding, and Overdue if it passes the due date.
- Payment recorded — part payments reduce the balance; when payments equal the total the invoice becomes Paid. Statement, portal, Payments, Monthly Revenue vs Wages and Finance all update.
- Profit — Finance & Profit per Week shows income less wages less running costs for that week.
24.2 What each figure really counts
| Figure | Counted when | Where to see it |
|---|---|---|
| Revenue earned | Job card signed off | Closed Jobs, Monthly Revenue vs Wages, Finance |
| Invoiced | Invoice created | Invoices, Operations Report |
| Cash received | Payment recorded | Payments, Monthly Revenue vs Wages, Finance |
| Wage bill | Shift allocated to a signed-off clean | HCP Wages, Finance |
| Wages paid | Marked paid with a payment day | HCP Wages, Monthly Revenue vs Wages |
| Running costs | Cost captured on Finance | Finance & Profit per Week |
24.3 Status dictionary
| Status | Applies to | Meaning |
|---|---|---|
| Draft | Quote, Invoice | Prepared in BMS, not yet sent. Reversible. |
| Sent (issued) | Quote, Invoice | Sent to the client; a reply or payment is expected. |
| Outstanding | Invoice | Money still owing, including part-paid invoices. |
| Overdue | Invoice | Outstanding past the due date. |
| Paid | Invoice | Payments equal the total; nothing owing. |
| Completed | Clean / job card | Signed off by the team leader. Revenue earned; billable. |
| Completed with an exception | Clean / job card | Completed, with the issue written into the team leader's sign-off notes. There is no separate status in BMS V1. |
| Cancelled | Clean / job card | Called off. No revenue, no wages. |
26. Golden rules
- Work runs Monday to Friday, in three fixed shifts, with at most two properties at a time.
- No sign-off, no money. An unsigned clean earns nothing and cannot be invoiced.
- Never delete a clean to correct it — move it. Deleting destroys the record; moving keeps the audit trail.
- Every team needs a TL/QC cleaner.
- Fix a price on the care plan, not on the invoice.
- Record part payments exactly as received; never edit the invoice total.
- Accept BMS's duplicate client warning — one client, one record.
- Wages are per shift, at the rate effective on the clean's date, with the weekly minimum applied.
- Capture running costs as they happen.
- Only the Owner changes Settings; changing a job's required cleaners or deleting its job card needs an Owner or Manager password.
- A Broomstix (in-house) day booked on Property B is paid to the cleaner as a shift, but is never priced and never invoiced to any client.
*Broomstix Management System (BMS) — User & Operations Manual · Version BMS V1.1 — 29 September 2026*
