HodariQ
Ctrl K
Back to siteBook a demo

Getting started

  • How HodariQ works
  • Set up your firm
  • Country, currency and dates
  • Users and roles
  • Approvals
  • Sending documents: e-mail and WhatsApp
  • The change log
  • Plans and limits
  • Features and switches
  • What must come first

Contracts

  • Create a contract
  • Commercial terms
  • Key dates and contract states
  • The contract workspace
  • Programme of works
  • Parties
  • Completion and closing
  • Consultant or contractor firm

Bills of Quantities

  • Build a BoQ
  • Lines, sums and totals
  • Units
  • Measurement sheets
  • Import from Excel
  • How the import reads a file
  • Paste and copy
  • Rates and build-ups
  • Price list, regions and the Price Book
  • Print the BoQ
  • Export to Excel
  • Tender, lock and revise
  • Compare revisions

Take-off

  • Start a take-off
  • The screen, keyboard and tablet
  • The scale
  • Lengths, areas and counts
  • Rooms: one click or every room
  • Roofs and wall centre lines
  • Doors, windows and symbols
  • Assemblies
  • Heights from sections
  • Zones
  • Send to the BoQ
  • Print the take-off
  • Check a take-off
  • Revised drawings
  • Revision to a variation order
  • Queries to the architect
  • Quick Measure

Tenders

  • Tender analysis
  • Tenderers and their rates
  • Checks and ranking
  • Award and the tender report

Variations

  • Variation orders
  • Pricing VO lines
  • Approving a variation order
  • VO from revised quantities
  • The VO document and the register
  • Extensions of time

Valuations and certificates

  • The monthly valuation
  • How the certificate is worked out
  • Retention and its release
  • Advance payment and its recovery
  • Liquidated damages
  • Measurement sheets
  • Submitting, certifying and freezing
  • Claimed and certified
  • Printing certificates

Money

  • Invoices and payments
  • Withholding tax and VAT
  • Who owes what
  • Financial statement
  • Cost control
  • Budget line by line
  • Recording costs
  • LPOs (purchase orders)
  • Suppliers and their prices
  • Schedule of materials
  • Subcontracts
  • Subcontractor certificates
  • Cost plans

Site Portal

  • Add your site team
  • On site: the phone pages
  • The daily report from the phone
  • Chats and photos
  • Notifications on the phone
  • Material requests at the office
  • Who approves, and the settings
  • Daily reports at the office
  • Work done, item by item
  • Who sees what

Inbox and Work

  • How the Inbox works
  • Connect the mailbox
  • How e-mails are sorted, summarised and dated
  • Which contract an e-mail is about
  • Check and approve e-mails
  • My work: reply, notes and Done
  • Alerts, the morning e-mail and the contract

Bids and the NeST scout

  • How bids work
  • Bid or no bid, and the documents
  • Results, the win rate and the contract
  • The NeST scout
  • Bid alerts

Team

  • Team: who has how much work

Registers and alerts

  • Bonds, insurance and documents
  • Alerts
  • The dashboard and the financial statement
  • The contractor portal
Ctrl K
Docs/Contracts

Create a contract

The New contract window: number, employer, dates, the terms of your last contract and the first BoQ, in one step.

A contract is the record every other document hangs on: its BoQs, variation orders, payment certificates, invoices, costs and subcontracts. It holds the parties, the key dates and the commercial terms (retention, advance, VAT, withholding tax, liquidated damages) that every certificate is worked out from. You make it once, in one small window, and fill in the rest later on its full form.

Make the contract

  1. 1Go to Contracts › Contracts and press New. The New contract window opens.
  2. 2Contract no. is optional. Type the employer's contract or tender number (for example PPRA/DSM/W/2026/014), or leave it empty and HodariQ gives the firm's next number, such as HQ/2026/001.
  3. 3Choose the Employer from the list. If the employer is not there yet, pick + New employer… and type the name; List takes you back to the list.
  4. 4Type the Title, for example Proposed 3-storey residential building, Mikocheni.
  5. 5Fill Contract date (today is proposed), Possession and Completion. They can also be left for later.
  6. 6Keep Same terms as my last contract ticked to copy the terms of the firm's most recent contract (the box shows its number). Untick it to start from the standard defaults below.
  7. 7Under Start the BoQ choose Import Excel (the BoQ you have), Copy a project (pick a past BoQ in the list that appears) or Empty (measure or type it).
  8. 8Press Create contract. The button stays grey until there is a title and an employer (and, for a copy, the BoQ to copy).

HodariQ then makes the contract in Draft, makes its first BoQ and opens it: with Import Excel the import window opens straight away over the new BoQ, with Copy a project the lines of the chosen BoQ are already copied in, with Empty the BoQ opens blank. The note at the foot of the window says it: contractor, consultant and terms can be changed on the contract.

What is filled in for you

  • Your own firm is put in its box: as Contractor when the firm acts as a contractor, as Consultant QS when it acts as a consultant (Settings › Our Firm › We act as).
  • A new employer typed in the window is saved as a company with the type Employer, so it is offered on the next contract.
  • The number comes from the firm's sequence HQ/year/three digits. A number can be used only once in a firm: a second contract with the same number is refused with the message This contract number is already used.
  • A cost tracking account is made for every contract, named after its title and coded with its number, and renamed when you rename the contract. Invoices to the employer and subcontractor bills carry it, so income and costs can be reported per contract. Contractor firms see it as Cost tracking account on the contract form (Senior QS / Manager and Accounts).

Same terms as my last contract

The tick copies these terms from the newest contract of the firm: retention %, retention limit, retention on materials on site, release at practical completion, materials on site % allowed, the advance type, advance %, the recovery method, recovery % and number of certificates, the VAT, withholding tax %, payment period, how liquidated damages are charged and their limit, the defects liability period and the form of contract.

Good to know

Two figures are never copied because they belong to one contract only: the liquidated damages amount and a fixed advance amount. Type them on the new contract's Commercial Terms tab if it has them.

The defaults without the tick

TermStarts at
Retention %10
Retention limit (% of contract sum)5
Released at practical completion (%)50
Materials on site: % allowed100, with retention taken on them
Advance paymentNo advance payment (if chosen: 10%, recovered at 20% of each gross valuation)
VATThe firm's default sales VAT (18% for a Tanzanian firm)
Withholding tax %The firm's rate in Settings › Our Firm (5% for a Tanzanian firm)
Liquidated damages0, charged per day, limit 10% of the contract sum
Payment period (days)28
Defects liability period (months)12
Form of contractPPRA standard

Who may do it

A QS Officer creates contracts and prepares them while they are in Draft: parties, dates and every term. Once the contract is started, only a Senior QS / Manager changes it; Accounts and Director users only read contracts. A draft contract can be deleted by a Senior QS / Manager; a started one cannot (the message says Only a draft contract can be deleted. Archive it instead.).

Tip

A party's Contracts button (Registers › Parties) opens a new contract with that party already in its box, when the party has no contract yet.

← PreviousWhat must come firstNext →Commercial terms

Something unclear? Ask us on WhatsApp: we answer the same day.

On this page

  • Make the contract
  • What is filled in for you
  • Same terms as my last contract
  • The defaults without the tick
  • Who may do it