Running the job

Agreements

7 min read

Agreements

Write an agreement — or bring in one you already have — send it to the people who need to sign, and keep the signed copy. They sign on their phone from a link. They do not need a QSME account.

A subcontract, an NDA, a variation, site rules: anything two or more people need to put their name to. Agreements is in the sidebar for both sides, because a tradie is sent agreements as often as a builder sends them.

Once an agreement has been sent, its wording is locked. Nobody signs something that can change underneath them. To change it, withdraw it and send a new one — both stay on the record.

Agreements is free on every plan. The AI actions use AI credits, like every other AI action in QSME.

AI here helps you write. It does not read your own agreement back to you — it is already in front of you.


Starting one

New agreement gives you four ways in.

A QSME templateAlready written, in plain words: a Subcontract agreement (NZ), a Confidentiality agreement (NDA) and a Variation. Change what you need.
One of your templatesAny agreement you wrote can be saved as a template. After a month these are the ones you will actually use.
Bring in one you already haveA PDF, a Word .docx or a photo, up to 20 MB — one of this project's documents, or the words pasted straight in. See below.
A blank pageWrite your own, one term at a time.

Want AI to write it? Start with a blank page and press Write it with AI — AI works inside the document, where the words are. See Writing with AI.

QSME's templates are a starting point, not legal advice. Anything that has to be filled in is left in [square brackets] so it is obvious on the page. Read every term, and on a large or unusual job have a lawyer check it.


Bringing in a document

Where the words are

A fileA PDF, a Word .docx, or a photo of a printed page. Up to 20 MB.
Already in QSMEOne of this project's documents. The subcontract somebody e-mailed is usually filed there already, so there is nothing to hunt for on a phone.
Paste the wordsCopy the agreement out of the e-mail or the Word file and paste it in. Headings, numbered terms and all.

What is it about?

Before you choose how it is used, you can tell QSME who it is with — one of your contacts — and what it is for: a contract, a tender, an SOQ, a job on the schedule. This is optional, and it is the single thing that makes the biggest difference.

Say it, and the agreement comes out with the real name, the real company, the real site and the real contract sum in it. Leave it out, and the same agreement comes out with [Subcontractor], [site address] and $[amount] for you to fill in afterwards.

Saying who it is with also puts that person on the signing line straight away, so all that is left is to read it and press Send. Nothing is sent until you do.

How it is used

One question decides everything that follows, so it is asked outright.

What happensAI credit
Keep every wordThe document's own words become the agreement. QSME works out where each term begins and ends, which lines are headings, and where the signature lines were — and changes nothing else. You can still edit any term afterwards. Nothing reads it, so nothing can reword it.None
Write it up as a proper agreementFor notes, an e-mail, or a rough draft. QSME keeps every point of the deal, leaves out what was never part of it, and writes it up the way its own agreements are written — using what it knows about this job. The wording will be new.One
Sign it as it isThe file is the agreement. Nobody can change a word of it, and nobody can edit it here either. Everyone reads the original, and the signatures go on pages added after it. PDF only.None
Let AI read itFor a photo or a scan, where the words have to be read off the page but must not change.One

Keep every word is the usual one. It needs a document that HAS words in it — pasted text, a Word file, or a PDF that was written rather than scanned. A photo has no words to keep, only a picture of them, and QSME says so and offers to have AI read it instead.

Blanks somebody left to fill in by hand — $________, a dotted line — come through as [blank], so the page can count them and Fill them in with AI can find them. The signature lines at the bottom of a paper contract are replaced by QSME's own signing area, so the signed copy does not end up with two.

If you paste a page rather than a document — a chat window, a search result, an article — QSME says so before it makes anything, because laying that out word for word gives you a wall of text with a signing area under it. You then choose: have it written up as an agreement, or keep it exactly as it is if you meant it.

Write it up as a proper agreement is the one to use when what you have is not a document yet: a few lines about the deal, an e-mail thread, a quote with the terms buried in it. You can add a sentence of your own — "a subcontract for the plumbing, they supply everything, we pay on the 20th" — and it is written into the document. Because the wording that comes out is new, you read it and tick that it says what you agreed before it can be sent, the same as anything else AI touched.

If you choose Let AI read it, AI can misread a scan, skip a line or split a term in two. So before it can be sent you open the original beside it, read the two together, and tick "I have read this against the original, and it says the same thing." Change the wording afterwards and the tick comes off again — it was a promise about the old words. Nothing read a document brought in with Keep every word, so there is nothing to tick: it goes out like any agreement you wrote yourself.

Either way the original stays attached — the file you brought in, or the words you pasted — so anybody can see where the terms came from.


Writing it

An agreement is a list of pieces, not a blank page. Each piece says what it is, and the page looks after how it prints.

PieceWhat it is
TermOne thing both sides agree to. Numbered for you.
TextOrdinary wording that is not a numbered term.
HeadingA title for the section below it.
DetailA label and its answer on one row — Site, Contract sum, Start date.
SignaturesWhere everyone signs.
New pageStarts the next part on a fresh page.

Terms number themselves, so adding one at the top never means renumbering the rest. Press Enter at the end of a term to start the next one. The ⋯ on each piece moves it, removes it, or turns it into a different kind of piece.

It saves as you type. While there are blanks left in [square brackets], the page tells you how many.


Writing with AI

AI sits inside the document, in three places. Every one shows you what it wrote first — nothing on the page changes until you accept it.

WhereWhat it does
Write with AIBetween any two pieces, or Write after this with AI… in a piece's ⋯ menu. On an empty page: Write it with AI.You say what you want — "a term about retentions", "the scope from the tender". It writes the new pieces for that spot, knowing what is already on the page. On an empty page it writes the whole agreement. Add these puts them in.
Reword with AI…A piece's ⋯ menu.Rewords the piece you point at, the way you ask. Old and new side by side; Use this swaps it.
Fill them in with AIThe bar that counts your blanks.Offers a value for each [blank] your own records answer. Before and after for every one; untick any you do not want.
AI never makes up an amount, a date or a name. Anything it was not given stays a [blank] for you.

What it is given comes from your own records — who is signing, the project, and whatever the agreement is linked to:

Linked toWhat AI can use
A contractThe agreed sum with its GST basis, retention, the stages, the dates and the scope. If the contract does not say whether the sum includes GST, the GST wording stays a blank.
A tenderWhat it is for, its dates, retention, and the scope by name and quantity. Never your estimated rates or amounts.
An SOQThe list of work, by name and quantity. Never the prices — an SOQ is your estimate, and an agreement goes to the other side.
A taskIts dates, how many days, and the trade.
A sheetIts name and what it is for.

Fill them in with AI can only change what is inside the square brackets: QSME swaps the value in itself, so the words around a blank cannot move. If nothing in your records answers the blanks, it says so and uses no credit.


How it prints

The printed copy is headed by the agreement's own name, on your letterhead. The top right corner carries only its reference and whether it has been signed.

Want a word up there — Subcontract, Letter of intent, Site rules? Type it in Top right of the printed copy, under the agreement's name. It is empty to begin with, and it locks with the wording when you send.


A document alongside

Drawings, a schedule of rates, the original the terms were typed up from: Attach a PDF puts it beside the terms.

The people signingSee "There is a document attached to this agreement", above the place they sign, and open it from there.
What their signature coversThe terms and the attached document. The fingerprint on the certificate is worked out from both.
The signed copyThe terms name the attached document as part of the agreement, and it is bound in at the back, after the signatures and the certificate.
Show it to the people signingOn to begin with for a PDF you attach. For a document you brought in, the original starts as yours alone — switch this on to show it to them as well.

PDF only, up to 20 MB, and only while the agreement is a draft. A Word original can be kept, but only you can see it.

If you want people to sign the original itself, with nothing re-typed, bring it in with Sign it as it is instead.


Who signs

Add people from your contacts, or type in a name and an e-mail address for someone who is not in them yet. Give each person the part they are signing as — Head contractor, Subcontractor, Client.

You sign your own agreement too. That is switched on to begin with; switch it off for the rare document only the other side signs.

Several people can sign, in any order. It is finished when the last one signs.


Sending it

Send for signing locks the wording and e-mails each person their own link. The e-mail says who it is from and what it is called. It is headed with your business name and logo when you have set them in your profile, with QSME in the footer.

No account neededThe link opens the agreement in a browser, on a phone. Nothing to install.
How long a link lasts60 days.
RemindSends a fresh link to whoever has not answered, good for another 60 days.
WithdrawStops every link straight away. The agreement stays on your list as withdrawn, so there is a record that it was sent.

What the other person sees

In the order they ask the questions: who this is from, the whole agreement, who else is signing, and only then — sign or decline.

To sign, they type their full name, can draw their signature with a finger or a mouse, and tick "I have read this agreement and I agree to sign it electronically." Drawing is optional; the typed name and the tick are not.

If they do not agree, they say so and are asked why — and you are told what they said. One person declining stops the agreement, rather than leaving it half-signed.

They can download a copy before and after signing. They see the names of the other people signing and how far along it is; they are never shown anybody's e-mail address.

You sign yours in QSME, with Sign it yourself.


The signed copy

When the last person signs, QSME makes the signed PDF on your letterhead: the agreement, each signature, and a certificate page behind them.

On the certificate
WhoEach person's name, e-mail address, and the part they signed as.
What they didThe name they typed, that they agreed to sign electronically, when they opened it and when they signed.
Where fromThe network address and device it was signed from.
What they signedA fingerprint (SHA-256) of the exact wording. Change one character and it no longer matches.

If the agreement belongs to a project, the signed copy is filed in that project's Documents, in an Agreements folder. It is always downloadable from the agreement itself — and what you download is that filed copy, so its fingerprint matches the one on record.

A document you brought in to be signed as it is is never re-typed: the signed copy is your original, untouched, with the signature and certificate pages added after it.


What an agreement is about

An agreement can belong to one project, several, or none — an NDA sent before there is a project is an ordinary case. The Agreements list shows all of them; one tap narrows it to the project you are on.

An awarded job, as an agreement

An awarded job is already an agreement in every sense except that nobody ever signed anything: both sides know the sum, the dates and the stages. QSME printed a contract with a blank signature block on it and left the signing to paper.

Agreements now shows those jobs at the top of the page — "2 awarded jobs have nothing signed for them" — and Make the agreement writes the real thing in one tap:

  • the job's own figures as the wording: the agreed sum with its GST wording, the dates, the retention, the scope, and the payment stages in order
  • both parties already on the signing line
  • the contract QSME issued attached to it, shown to whoever signs and bound into the signed copy
  • the job linked, so the job's page finds the agreement and the agreement finds the job

It is a draft. Read it, change what you want, then either send it to be signed or leave it on file. An agreement nobody was asked to sign is still the record of what was agreed, kept where the rest of the paperwork is.

New agreement on an awarded job's own page does the same thing, so it does not matter which side of the platform you start from.

Your signature, kept

Signing asks for two things: your name, and your signature. Once you have drawn it, Keep this signature for next time stores it against your QSME account, and every agreement after that offers it back with Draw a different one beside it. Forget it throws the picture away, and nothing already signed changes.

It is kept per account, never in a browser. Somebody signing from a magic link with no QSME account draws theirs, or just types their name, exactly as before — a signature is never left in the storage of whatever device opened a link.

What is reused is the picture, and a picture proves nothing on its own. What a signature is evidence of is recorded against each agreement separately: your typed name, your consent, the moment, your IP address, and a fingerprint of the exact wording you signed.

Bringing the job's own details into the wording

Bring in from this job sits beside Add a term everywhere a piece can be added, and on the empty page. It writes what QSME already holds straight into the document, so nothing has to be typed twice.

What lands on the pagePrices
SOQThe work it lists, by name and quantity.No
TenderWhat the work is, what was listed, the dates and the retention asked for.No
ContractThe agreed sum with its GST wording, the dates, the retention, the scope, and the payment stages in order.Yes
Job on the scheduleWhen it starts and when it has to be finished.No

Tick as many as you need, across all four kinds, and bring them in together. An agreement for a landscaping package is usually the SOQ's work, the contract's sum and a couple of dates off the programme, and that is one thought rather than four trips. They land in the order you ticked them, up to ten at a time. If one of them cannot be read, none of them go in — half an agreement filled in is worse than none of it.

No AI and no credit: the pieces are built from the record itself, so the page says what the record says. Bringing something in also links it, which is what makes Fill them in with AI work afterwards and what lets the job's own page find this agreement.

Why prices only come from a contract. An SOQ and a tender hold your estimate. This document goes to the other side, so those figures stay where they are. A contract's agreed sum is a figure both sides already shook hands on, so it comes across in full, always with the GST wording beside it. Where the contract does not say which basis it is on, that is left in [square brackets] rather than guessed.

The new pieces land at the end of the wording, above the signing area, or straight after whichever piece you pressed Bring in on. Edit them like anything else afterwards.

Linking it to a contact, a tender, a contract, an SOQ, a task or a sheet

Under What it is about, Link something ties the agreement to what it concerns — as many as it needs, of any kind.

What you can linkWho it is with — one of your contacts — plus tenders, contracts, SOQs, tasks on the schedule, and sheets you run.
Where it looksOn the project the agreement is about first. Look in all my projects widens it.
From either sideA tender, a job and a task each show their agreements on their own page, with a button to link one you already have. It is the same link whichever side you make it from.
Opening oneEach link opens in a new tab, so you do not lose the agreement you are writing.
Who sees themOnly you. The people signing never see what an agreement is linked to.
After sendingLinks are filing, not wording — you can add and remove them after an agreement has gone out, or been signed.

A link is also where AI gets its facts. Fill them in with AI can only fill in the contract sum once the agreement knows which contract, and it can only put the other side's name and company in once the agreement knows who it is with. You can say both when you bring a document in, before anything is written, which is why an agreement made that way comes out filled in rather than blank.

On a tender

In a tender's Bids, the person running it can choose An agreement for the winner. When the tender is awarded, QSME makes that agreement for whoever won and fills in what an award knows — who the two parties are, and the site.

If…Then…
Nothing is left in [square brackets]It is sent to the winner to sign, by itself.
Blanks remainIt waits as a draft with both of you already on it, and you are told it is ready to check and send.

QSME never fills in the money. The awarded figure has a GST basis, and a contract sum stated on the wrong one is a dispute, not a convenience. Every QSME template has blanks, so those always wait for you; your own finished terms send themselves.

Awarding works exactly the same with or without an agreement. Nothing is held up by one.

On a job

Each job in Active Work has an Agreements card that both sides see. The client sees what they sent and whether it is signed, can start a New agreement with both parties already on it, or Link one they already have. The tradie sees what they have been asked to sign.

On a task

A task's page on the Schedule has an Agreements section. Whoever runs the programme can Link one; anybody named on a linked agreement sees it there.


AI, and what it will not do

What it doesWhat it never does
Write with AIWrites new pieces where you ask — or the whole agreement on an empty page — in plain language.Add anything until you press Add these. Make up an amount, a date or a name: what it was not given stays a [blank]. Use a price from an SOQ or a tender estimate.
Reword with AI…Rewords the piece you point at, the way you ask. You see the old and the new side by side.Change anything until you press Use this. Touch a piece you did not point at.
Fill them in with AIOffers a value for each [blank] your records answer, before and after.Change a word outside the square brackets. Fill a blank nothing answers. Charge a credit when it found nothing.
Let AI read itReads a photo or a scan you brought in and turns it into terms.Paraphrase or tidy. It copies the words, and you check them against the original before it can be sent. It is not used at all when you choose Keep every word — QSME lays those out itself.
Write it up as a proper agreementTurns notes, an e-mail or a rough draft into a document, using what QSME knows about the job.Invent a fact, or make up a price. Anything it was not told stays a [blank]. It will not write an agreement out of a page that has no deal in it — it says so instead.

Each one uses one AI credit, and gives it back if it fails. If your credits are used up, every one of these has a way to carry on by hand, and the message says what it is.

AI does not summarise your agreement or tell you what it says, and it never says whether a term is fair or legal. None of this is legal advice.


Signing electronically

In New Zealand an electronic signature is valid when it identifies the person, shows they approved the document, and is as reliable as the purpose needs. That is what the link, the typed name, the tick and the certificate are for.

A few documents cannot be signed electronically — wills, affidavits and a handful of others. The signing page says so.


What it does not do yet

Placing signature boxes on a pageSignatures go in the signing area, or on pages added after a document signed as it is. You cannot drag a box onto page 6.
A set signing orderEveryone is asked at once.
Witnesses, and initials on every pageNot supported.
Agreements listed on an SOQ or a sheetAn SOQ or a sheet can be linked, and the link shows on the agreement. The SOQ and the sheet do not list their agreements on their own pages yet — tenders, jobs and tasks do.
Attaching more than one documentOne PDF alongside the terms. Combine them into one file first.
The phone appAgreements is not in the app yet. Open QSME in your phone's browser — every screen here works on a phone.

Words you will see

WordWhat it means
TermOne numbered thing both sides agree to.
BlankAnything still in [square brackets], waiting to be filled in.
Signing asThe part a person plays — Head contractor, Subcontractor.
Sign it as it isThe file you brought in is the agreement, unchanged.
AlongsideA PDF sent with the terms. It is part of what is signed, and is bound into the signed copy.
LinkWhat ties an agreement to a tender, contract, SOQ, task or sheet. Only you see it.
WithdrawnTaken back by whoever sent it. The links no longer work.
CertificateThe page behind the signatures that records who signed, when and what.
FingerprintA code worked out from the exact wording. The same words always give the same code.

More on the words: the glossary.


If something looks wrong

What you seeWhat it means
Send for signing is greyed outNothing is written yet, nobody else has been added to sign, or — for a document AI read — you have not ticked that you checked it against the original. The line under the button says which.
You need to change the wording after sendingYou cannot. Withdraw it and send a new one.
They say the link does not workLinks last 60 days, and stop when an agreement is withdrawn. Remind sends a fresh one.
The winner did not get the agreement when you awardedIt had blanks, so it is waiting for you as a draft — or there is no e-mail address for whoever won.
"Only a PDF can be signed exactly as it is"Save the document as a PDF and bring that in, or choose Keep every word.
"There are no words in that document for QSME to lay out"It is a scan or a photo. Choose Let AI read it, or bring it in to be signed exactly as it is.
An old Word file (.doc) is refusedOpen it in Word and save it as .docx or as a PDF.
The tick came off "I have read this against the original"The wording changed after you ticked it. Read it against the original again.
Fill them in with AI says there is nothing to fill fromIt only uses your own records. Add who signs, tick the project, or link the contract, tender or task — then try again.
A blank was left after fillingNothing in your records answers it. Fill it in yourself, or take the term out.
The top right of the printed copy is emptyThat is how it starts: the page is headed by the agreement's name. Type a word in Top right of the printed copy if you want one.
You cannot take the attached document offIt is the original of a document you brought in, which the wording was checked against. You can stop showing it to the people signing.
The tender, contract or task you want is not in the listThe list starts on the project the agreement is about — press Look in all my projects. You can only link things you run.
You cannot find the signed copyOpen the agreement and download it. If the agreement belongs to a project, it is also in that project's Documents, under Agreements.

Still stuck? hello@qsme.co.nz, or +64 27 338 8500.