System Manual

The complete BroomStix Management System user and operations manual — BMS V1.

Chapters

2. Logging in and user access

Purpose. To make sure each person sees and changes only what their role allows.

When to use it. At the start of each working session, and whenever a new staff member or client needs access.

Step-by-step.

  • Open the BMS address in your browser. The Sign in screen appears.
  • Enter your email address and password, then choose Sign in. Google sign-in is also available.
  • Forgotten password: choose the reset option, then follow the link emailed to you to set a new one.
  • To see who has access: Settings → People & access and Who may do what.

*Sign-in screen*

*Settings — People & access*

What happens next. Every record you create is stamped with your franchise, so you only ever see your own franchise's clients, staff, cleans and money.

Rules & warnings.

  • Roles are Owner, Manager, Viewer, HCP and Demo.
  • Only the Owner may change the values in Settings (pay rates, shift times, cars, estates, frequencies).
  • A Demo account is read-only: it can look at everything and change nothing.
  • Deleting a job card requires an Owner or Manager password re-entered on the spot.
  • Never share a login. The change history records the email address of whoever acted.

The Client & Cleaner Portal

Purpose. A separate, simple screen for people outside the office.

  • A client signs in and sees their own statement, what has been invoiced, what has been paid, what is outstanding, their upcoming cleans, and can request a quote.
  • A cleaner signs in and sees their own shifts, logged hours, wage totals, the bank details held on file, and their upcoming allocated cleans.

*Portal — client view*

*Portal — cleaner view*

Rules & warnings. A portal account only ever shows the records that match that person's email address. A quote request from a client lands at the top of Enquiries for you to action.


4. Enquiries

Purpose. The first step of the funnel: every phone call, email, WhatsApp or portal quote request is logged here so nothing is lost.

When to use it. The moment somebody makes contact.

Step-by-step.

  • Open Enquiries → Enter a new enquiry.
  • Capture the client's name, phone number, email, address, Estate / complex (choose from the list, or *None*), property type and the source of the enquiry.
  • Add notes about what the client asked for. Save.
  • Move the enquiry along as it progresses: New → Appointment booked → Assessed, or mark it Lost with a reason.
  • Quote requests from the client portal appear in their own panel at the top — action these first.

*Enquiries — register and Enter a new enquiry*

What happens next. Booking the assessment carries the client's details into the Home Assessment, so you don't retype them.

Rules & warnings. Always record a lost reason — the *Why enquiries were lost* panel is your marketing feedback. An enquiry on its own creates no client, no price and no clean.


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

StatusMeaning
DraftCreated in BMS, not yet sent to the client. Can still be undone.
Sent ("Issued")Sent to the client; the money is now expected.
OutstandingAny amount still owing on a Sent invoice — including part-paid invoices.
OverdueOutstanding past its due date. Chase it.
PaidPayments received equal the invoice total. Nothing left owing.

17. Issuing invoices and recording payments

Purpose. To get the invoice to the client and to record the money coming back.

When to use it. Immediately after generating invoices, and every time a payment lands in the bank.

Step-by-step — issuing.

  • From the Invoice register on the Invoices page, open the invoice and press Preview & send to email it to the client — or print / save it as a PDF and send it yourself, then press Mark as sent.
  • To send to many clients at once, open Client Email List, choose what to send (latest quote, invoice or statement), tick the clients, send, and read the Send results.

*Client Email List — what to send and client selection*

Step-by-step — recording a payment.

  • Open Payments. A reminder at the top counts the invoices that are overdue.
  • Find the client's invoice under Client invoices and click the invoice reference — the payment box opens with the client's name in bold.
  • Enter the payment date, the amount (the outstanding balance is offered by default), the method, a reference and any notes.
  • Save. Part payments are fully supported — record exactly what came in, as many times as it takes, until the total is reached. Closing the box without saving records nothing.

*Payments — client invoices and payment capture*

What happens next. Balances, invoice status, the client statement, the client portal, Monthly Revenue vs Wages and Finance & Profit per Week all update automatically. Counters show Received, Outstanding, Fully paid invoices and Part paid.

Rules & warnings.

  • Never adjust an invoice total to match a short payment — record the part payment and leave the balance Outstanding.
  • Anyone in your business can record a payment on any invoice — payments are not tied to whoever created the invoice.
  • Client statements net off every recorded payment, so a part payment shows correctly on the statement.
  • If email sending is unavailable (the sending domain must be verified before BMS can email on your behalf), print or save documents as PDFs and send them from your own mailbox.

19. HCP Wages & Shifts (paying the cleaners)

Purpose. To see every cleaner's shifts for a period and record what you paid them.

When to use it. Weekly, when you pay staff.

Step-by-step.

  • Open HCP Wages & Shifts and set the Period.
  • Read the counters: HCPs with shifts, Shifts allocated, Wages paid, Still outstanding.
  • Expand a cleaner under Per HCP. The row summary shows Shifts, Worked and Upcoming prominently, with their bank name, account number, branch code and email.
  • Each clean is listed with its weekday and date and client, and is clickable — it opens that job card.
  • Set the Payment day, then use Pay X shifts for the whole cleaner, or Mark paid per line.
  • Open the printable wage slip — cleaner, period, each shift, client, status, paid date, amount, paid and outstanding totals and bank details — to print or save as a PDF.
  • Email the cleaner their paid and outstanding shifts where an email address is on file.
  • Payments made to staff shows what was paid, to whom, on which day, for how many shifts.

*HCP Wages & Shifts — Per HCP expanded*

*Wage slip document*

*Payments made to staff*

What happens next. Paid and outstanding wages feed Monthly Revenue vs Wages; the cleaner sees the same figures in their portal.

Rules & warnings.

  • The wage for a clean uses the rate that applied on that clean's date (Settings → *Rate per shift from a date*), with a cleaner's own rate taking precedence.
  • Changing today's rate does not rewrite past wages — that is deliberate.
  • A cleaner with no email address cannot be emailed a statement; BMS says so instead of failing.

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

FigureCounted whenWhere to see it
Revenue earnedJob card signed offClosed Jobs, Monthly Revenue vs Wages, Finance
InvoicedInvoice createdInvoices, Operations Report
Cash receivedPayment recordedPayments, Monthly Revenue vs Wages, Finance
Wage billShift allocated to a signed-off cleanHCP Wages, Finance
Wages paidMarked paid with a payment dayHCP Wages, Monthly Revenue vs Wages
Running costsCost captured on FinanceFinance & Profit per Week

24.3 Status dictionary

StatusApplies toMeaning
DraftQuote, InvoicePrepared in BMS, not yet sent. Reversible.
Sent (issued)Quote, InvoiceSent to the client; a reply or payment is expected.
OutstandingInvoiceMoney still owing, including part-paid invoices.
OverdueInvoiceOutstanding past the due date.
PaidInvoicePayments equal the total; nothing owing.
CompletedClean / job cardSigned off by the team leader. Revenue earned; billable.
Completed with an exceptionClean / job cardCompleted, with the issue written into the team leader's sign-off notes. There is no separate status in BMS V1.
CancelledClean / job cardCalled off. No revenue, no wages.

25. The Broomstix operating rhythm

Every day

  • Dashboard — clear Waiting final QC and Understaffed.
  • Action new Enquiries and portal quote requests.
  • Sign off yesterday's job cards.

Every week

  • Capture Shift Availability for the coming week.
  • Confirm teams and team leaders on the Weekly Schedule.
  • Empty Jobs still to close.
  • Pay staff on HCP Wages, send wage slips, and use Payroll by Month for bank reconciliation.
  • Capture running costs and review Finance & Profit per Week.
  • Work the Operations Report action list.

Every month

  • Generate invoices, issue them, and send statements from the Client Email List.
  • Chase Overdue invoices.
  • Review Monthly Revenue vs Wages.

Every year

  • Load next year's public holidays in Settings and decide on the affected cleans.
  • Review the rate per shift with a new effective date.