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
- 1Go to Contracts › Contracts and press New. The New contract window opens.
- 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.
- 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.
- 4Type the Title, for example Proposed 3-storey residential building, Mikocheni.
- 5Fill Contract date (today is proposed), Possession and Completion. They can also be left for later.
- 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.
- 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).
- 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
| Term | Starts at |
|---|---|
| Retention % | 10 |
| Retention limit (% of contract sum) | 5 |
| Released at practical completion (%) | 50 |
| Materials on site: % allowed | 100, with retention taken on them |
| Advance payment | No advance payment (if chosen: 10%, recovered at 20% of each gross valuation) |
| VAT | The 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 damages | 0, charged per day, limit 10% of the contract sum |
| Payment period (days) | 28 |
| Defects liability period (months) | 12 |
| Form of contract | PPRA 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.
Something unclear? Ask us on WhatsApp: we answer the same day.