Skip to content
teamsleek.ai

Module · Projects and progress claims

Project and progress claim software: the process, flow by flow

This module runs a contract from award to final account: the contract sum and its breakdown, the cost budget by cost code, commitments as POs and subcontracts are let, variations, monthly progress claims to the client, subcontractor claims coming in, retention held in both directions, and the monthly forecast of cost to complete. Every figure is held per project against the same contract items and cost codes, so claims, variations and the forecast read from one set of numbers.

Where it usually breaks: progress is retyped from last month's spreadsheet instead of measured from site; variations agreed on site are done and never priced or claimed; subcontractor claims are approved at the claimed percentage because the response date is close; and cost reports count bills instead of commitments, so an overrun shows up after the money is spent. Each flow below shows where each check sits and what it compares.

Process

The flows, step by step

Each step names who does it: a person, an agent, or the system applying a fixed rule. Agents draft and wait for approval. Payments, deletions and messages to customers or suppliers always stop at a person.

Agents in these flows: document intake agent and progress claim agent. Projects and progress claims is one part of the AI ERP.

End to end

  1. System

    Photos and notes from site

    Block C, week ending 31 Oct

  2. Agent prepares

    Site update drafted

    Work done by item

  3. Person decides

    Update confirmed

    Project manager

  4. Agent prepares

    Claim 6 drafted

    VOs, retention, previous claims

  5. Person decides

    Claim approved and sent

    Quantity surveyor

  6. System

    Invoice on certification

    Passed to finance

Sample data. Ridgeway Build Pte Ltd is not a real company.

Flow 01

Project setup and budget

The contract sum, its breakdown and the cost budget are what every later claim, variation and forecast is measured against. When they live in a tender spreadsheet that drifts from what was signed, claims are measured against the wrong values and nobody can say what margin was won at award.

Starts when
A letter of award or contract is signed for a new project.
Ends with
A project with a locked original contract sum, contract items and cost budget by cost code, contract terms with clause references, a claim calendar, and empty registers for variations, subcontracts, claims and retention.
  1. 1.Person: Contracts manager

    Creates the project from the letter of award with the client, contract sum, dates and payment terms.

    • Contract sum before GST must equal the letter of award figure.
    • Retention rate and cap, defects liability period, claim cut-off day, payment response period and payment period are entered with the clause number each comes from.
    • Each subcontract and PO is later tagged as a construction contract or a supply contract, because the Act sets different response and due date rules for each.
  2. 2.Person: Quantity surveyor

    Imports the priced BOQ or schedule of values as the contract items the client's QS will certify against.

    • The sum of contract items must equal the contract sum to the cent, or the import is rejected.
    • Provisional sums and prime cost sums are typed separately, since they are adjusted against actual cost and are not claimed by percentage.
    • For a schedule of rates contract, items hold a rate and an estimated quantity, and claims are measured quantity times rate.
  3. 3.Person: Quantity surveyor

    Maps each contract item to the cost codes that carry its cost.

    • Every contract item needs at least one cost code before the project can be approved.
    • Cost codes come from the company list; a new code needs the commercial manager.
    • Subcontract scopes are mapped to the same contract items, so a subcontractor's claim can be compared with site progress on the same items later.
  4. 4.Person: Project manager

    Sets the cost budget by cost code from the estimator's tender cost build-up.

    • Each budget line keeps the estimator's basis (quantity and rate), so later variances can be traced to a quantity or a rate.
    • Contract sum minus total budget gives the margin at award; a margin below the company minimum needs the director's approval with a note.
  5. 5.Person: Project director

    Approves the baseline of contract items, cost budget and contract terms.

    • After approval the original contract sum and original budget are locked; they change only through approved variations and logged budget revisions.
    • The approval is logged with the approver, the time and the baseline version.
  6. 6.System: System

    Builds the claim calendar and opens the project to site updates, requisitions and the progress claim agent.

    • Each claim date carries its payment response due date and payment due date, shown with the clause reference so the contracts manager can check them.
    • The progress claim agent gets read access to the approved baseline only; it cannot change contract items, the contract sum or the budget.

Exceptions

The BOQ total does not match the signed contract sum, for example after a negotiated discount
The QS adds the difference as its own adjustment item instead of spreading it across rates, so the items still add up to the signed sum when every item reaches 100%.
The client's QS uses a different breakdown from the tender BOQ
The client's breakdown becomes the contract items, because that is what gets certified, and the tender lines are kept only as the budget basis behind the cost codes.
Work starts on a letter of intent before the contract is signed
The project opens with a letter of intent status and a ceiling value. Requisitions and site updates are allowed up to the ceiling; any claim needs the project director until the baseline is approved.
The budget gives a margin below the company minimum
The project cannot be approved by the project director alone. The director approves with a written reason, and the project starts on the forecast watch list.

Flow 02

Committed cost against budget

A cost code goes over budget the day a PO or subcontract is approved, weeks before the bill arrives. Tracking only bills shows the overrun once the money is committed, when there is little left to change.

Starts when
A site requisition, purchase order or subcontract is raised against the project.
Ends with
An approved PO or subcontract recorded as a commitment on its cost code, an updated cost code position, and any budget transfer logged with its approver.
  1. 1.Person: Site supervisor

    Raises a requisition against the project, a cost code and, where it applies, a variation number.

    • The cost code must belong to the project and be open.
    • Cost for extra work must carry the VO number, so it can be shown against that variation instead of the base scope.
  2. 2.System: System

    Works out the cost code position before and after the request.

    • Spent and committed to date = actual cost booked + open PO balances + subcontract value not yet certified.
    • Position after the request = spent and committed to date + request value before GST, compared with the revised budget for that cost code.
    • Amounts are tracked before GST, since a GST-registered contractor recovers the GST on its bills.
  3. 3.System: System

    Applies the warning thresholds to the position after the request.

    • Below 90% of the revised cost code budget: no flag.
    • From 90% to 100%: the approver sees the warning and the budget left.
    • Above 100%: the project manager must give a reason and the project director must approve.
  4. 4.Person: Project manager

    Approves the requisition, sends it back with a different cost code, or raises a budget transfer.

    • Moving budget between cost codes is a budget transfer with its own approval and log entry, never an edit to the request.
  5. 5.System: System

    Records the commitment when the PO or subcontract is approved in purchasing.

    • A subcontract commits its full value at award; it draws down as claims are certified.
    • Subcontract value above the budget for the mapped contract items is shown as a buyout loss on the cost code.
  6. 6.System: System

    Moves cost from committed to actual as bills are approved and subcontract claims are certified.

    • A goods receipt marks the PO value as received not billed, and it stays in open commitments until the bill is approved. The approved bill then reduces the open PO balance by the same amount.
    • A certified subcontractor claim moves its certified gross value from committed to actual.
    • A PO closed short releases its unused balance back to the cost code.
  7. 7.System: System

    Shows the cost report by cost code with original budget, revised budget, actual, open commitments and budget left.

    • Original and revised budgets sit side by side, so an overrun from variations can be told apart from an overrun in base scope.

Exceptions

A supplier bill comes in above its PO
The difference is flagged at bill matching in finance, and the extra goes through the same threshold check on the cost code before the bill can be approved.
A subcontract is let for more than its budget
The buyout loss is shown at subcontract approval. Above the budget for its scope, the director approves the subcontract with a reason.
Materials are issued from the company store
The issue is costed at the store's valuation and booked as actual cost on the cost code, with no PO, through the inventory module.
Urgent work is ordered on site and the PO is raised afterwards
The commitment is recorded with the date the work was ordered and marked as retrospective, and retrospective POs are counted per project in the monthly report.
A cost code finishes its scope under budget
The project manager can move the balance to contingency as a logged budget transfer; it is never left sitting where it can absorb an overrun unnoticed.

Worked example

Scaffold hire on P-24-017

  • Preliminaries cost code: revised budget S$33,000.00.
  • Actual S$18,000.00 plus open POs S$3,600.00: S$21,600.00 spent and committed, 65.5% of budget.
  • Requisition for 8 weeks of scaffold hire: S$9,600.00 before GST.
  • After this PO: S$31,200.00, 94.5% of budget, in the warning band with S$1,800.00 left.
  • The project manager approves with the warning shown. Director approval would apply only above S$33,000.00.

Sample data. Ridgeway Build Pte Ltd is not a real company.

Flow 03

Variation orders

Variations lose money when work instructed on site is done and never priced, or is approved by the client and never claimed. Each variation needs one record from the instruction to the claim it was paid in.

Starts when
A site instruction, architect's instruction, client email or revised drawing changes the scope.
Ends with
A variation order with its instruction, price build-up, client decision and attachments; a revised contract sum; a budget revision by cost code; and a claim line ready for the next progress claim.
  1. 1.Agent: Document intake agent

    Reads the instruction and drafts a variation record with its reference, date, issuer, description and photos.

    • Matched to the project by project number, site address or the issuer's name on file.
    • Fields it cannot read clearly are left blank for the project manager, never filled with a guess.
    • An instruction from someone not named in the contract as able to instruct is flagged.
  2. 2.Person: Project manager

    Confirms the record, which gives it the next VO number and the status instructed, unpriced.

    • VO numbers run in sequence per project, so a gap shows a missing record.
    • Cost can be booked against a VO from this point, so its cost is captured even before it is priced.
  3. 3.Person: Quantity surveyor

    Prices the variation and splits its cost estimate by cost code.

    • Order of pricing follows the contract's valuation clause: contract rates where the work matches an item, then rates derived from them, then cost plus the agreed overhead and profit.
    • The cost estimate is split by cost code so it can become a budget revision once approved.
  4. 4.Person: Project manager

    Sends the priced variation to the client with its build-up and photos.

    • Messages to the client always stop at a person; the system never sends a VO by itself.
    • The sent date is recorded, and a VO with no answer after the follow-up days set for the project goes on the follow-up list.
  5. 5.Person: Project manager

    Records the client's decision with the signed VO or written approval attached.

    • Priced value and approved value are both kept when they differ.
    • Status becomes approved, rejected or approved at a different value; an unagreed balance stays as a separate pending item.
  6. 6.System: System

    Adds the approved value to the revised contract sum and adds the VO as a line on the next progress claim.

    • Revised contract sum = original contract sum + approved VOs; the original never changes.
    • The VO is claimed by its own work done percentage, separate from the base contract items.
  7. 7.Person: Project manager

    Posts the VO's cost estimate as a budget revision on the affected cost codes.

    • Revised budget = original budget + posted revisions, with each revision linked to its VO.
  8. 8.System: System

    Lists every instructed or pending VO in the weekly variation register and under each claim draft.

    • Sorted by age since instruction, with days since it was sent to the client and its value.

Exceptions

Work is instructed verbally on site
The site supervisor logs it from a phone and the record starts as verbal, written confirmation needed. The project manager asks the client to confirm in writing; the system only prepares the request.
The client accepts the scope but disputes the price
The VO is approved at the value the client accepts, which becomes claimable, and the balance stays as a separate pending item for the final account.
The client rejects a variation after the work is done
Its cost stays in the project cost and forecast, its value comes out of the register, and the QS decides whether to pursue it at final account. The decision is logged.
The variation omits work
It is recorded as a negative VO that reduces the revised contract sum and the budget, and open POs or subcontract scope for the omitted work are flagged for the project manager to reduce or cancel.
A subcontractor's work is affected
A matching subcontract variation is drafted against the subcontract, so the subcontractor's claim for the extra can be assessed against an approved figure.

Worked example

VO-05, extra partitions on P-24-017

  • Site instruction SI-14, 2 Oct: add three meeting-room partitions on level 4.
  • No contract rate for the acoustic partition type, so priced from cost: materials S$6,200.00 + labour S$2,800.00 = S$9,000.00.
  • Overhead and profit at the contract's 20%: S$1,800.00. VO-05 priced at S$10,800.00 before GST.
  • Client signed 16 Oct. Revised contract sum: S$480,000.00 + VO-03 S$7,600.00 + VO-05 S$10,800.00 = S$498,400.00.
  • Budget revision: materials +S$6,200.00, labour +S$2,800.00. Revised budget: S$408,000.00 + VO-03 S$6,400.00 + VO-05 S$9,000.00 = S$423,400.00.
  • Margin at award S$72,000.00 (15.0%); on the revised figures S$75,000.00 (15.0%).
  • VO-04, S$6,250.00, sent 24 Oct and still pending: not in the revised contract sum.

Sample data. Ridgeway Build Pte Ltd is not a real company.

Flow 04

Progress claims to the client

The monthly progress claim is the contractor's cash flow. Built by hand it is copied from last month's spreadsheet, so percentages drift from what site actually did, approved variations get missed, and retention or previous amounts are taken from the wrong column.

Starts when
The claim cut-off in the contract comes round (month end for P-24-017), or the QS asks for a draft before it.
Ends with
A numbered, submitted claim version with its working and evidence, the certified amount by item, a tax invoice passed to finance, an updated retention ledger, and the response and payment due dates on the claim calendar.
  1. 1.Agent: Document intake agent

    Turns the site team's photos and notes into a draft site update with work done by contract item.

    • Each percentage or quantity is tied to a contract item or VO; notes it cannot match are left unassigned for the project manager.
  2. 2.Person: Project manager

    Confirms the site update, correcting any percentage that does not match what was seen on site.

    • Only confirmed site updates count toward a claim.
    • An item cannot go above 100%, or below its last certified percentage, without a written reason.
  3. 3.Agent: Progress claim agent

    Drafts the claim from the confirmed updates, approved variations, retention terms and earlier certificates, with the working for every line.

    • Order: work done to date by item + approved VOs by their own percentage = gross value to date; less retention to date at the contract rate up to its cap; less the total certified in earlier claims; = this claim before GST; plus GST at 9%.
    • Amounts previously certified are deducted, not amounts previously claimed, so anything the client's QS cut last month is claimed again.
    • Pending VOs are listed under the claim with value and age, and are not added.
    • Items that move more than the jump threshold in a month, or pass the evidence percentage with no photo or note, are flagged.
  4. 4.Person: Quantity surveyor

    Checks the quantities against the site photos and approves the amounts.

    • Approver by value before GST: QS up to S$100,000.00, project director above (sample matrix).
    • Every change the QS makes to an agent figure is logged with the old value, the new value and the reason.
  5. 5.Person: Quantity surveyor

    Submits the claim to the client or the client's QS in the way the contract requires.

    • Submission is always by a person.
    • The submitted version is frozen as a numbered version; any later change creates a new version.
    • The service date is recorded, since the client's response period runs from it.
  6. 6.System: System

    Tracks the client's payment response or certificate against its due date.

    • Response due = the earlier of the contract's date and 21 days after the claim is served, or 14 days after service where the contract sets no date (Act, section 11(1)).
    • A missing response shows on the contracts manager's overdue list the day after it was due.
  7. 7.Person: Quantity surveyor

    Records the certified amount by item and the reasons given for any difference.

    • Certified percentages by item become the floor for next month's draft.
    • A difference above the amount set for the project goes to the commercial manager.
  8. 8.System: System

    Passes the certified amount to finance for the tax invoice and updates the retention ledger and payment due date.

    • Invoice = certified amount this claim before GST + GST at 9%.
    • For a GST-registered contractor, payment due = the earlier of the contract's date and 35 days after the tax invoice is submitted, or 14 days after the tax invoice where the contract sets no date (Act, section 8(1) and (2)).

Exceptions

The client certifies less than the claim
The certified amount is recorded and the shortfall comes back in the next claim by itself, because the claim deducts what was certified. Whether to dispute it is the contracts manager's call; the system shows the dispute settlement period, 7 days after the response was due (Act, section 12(6)).
No payment response arrives by the due date
The claim is flagged the next day with the dispute settlement period end date and, after it, the 7-day window to apply for adjudication (Act, section 13(3)(a)). The system shows the dates; the decision and any notice sit with the contracts manager and their adviser.
A pending variation is approved after the draft was made
The progress claim agent redrafts the claim as a new version, and the QS sees the difference between versions before approving.
An item's percentage goes down because of rework or removed work
The agent flags it and the QS confirms the lower figure. If this claim comes out negative, it goes to the project director before anything is sent.
Practical completion is certified
The retention due at completion (half, on P-24-017's terms) is added as a release line on the next claim, and a reminder is set before the end of the defects liability period for the balance.
Materials are delivered to site but not installed
They are claimed only if the contract allows it, as a separate line backed by the delivery order the document intake agent read, and deducted again once installed and claimed in the item.

Worked example

Claim 6 on P-24-017, Block C fit-out

  • Contract sum S$480,000.00 in 6 contract items; retention 5% of gross value.
  • Partitions and ceilings 90% of S$132,000.00: S$118,800.00. M&E 70% of S$168,000.00: S$117,600.00.
  • Preliminaries 62% of S$36,000.00: S$22,320.00. Flooring 30% of S$64,000.00: S$19,200.00.
  • Joinery 30% of S$56,000.00: S$16,800.00. Painting and finishes 12% of S$24,000.00: S$2,880.00.
  • Work done to date: S$297,600.00, 62.0% of the contract sum.
  • Approved variations, both complete: VO-03 S$7,600.00 + VO-05 S$10,800.00 = S$18,400.00.
  • Gross value to date S$316,000.00, less retention 5% S$15,800.00 = S$300,200.00.
  • Less certified in claims 1 to 5: S$246,240.00. This claim before GST: S$53,960.00.
  • GST 9%: S$4,856.40. Claim 6 total: S$58,816.40. The QS approves it (under S$100,000.00).
  • Retention held rises from S$12,960.00 to S$15,800.00. VO-04 (S$6,250.00) is listed, not claimed.

Sample data. Ridgeway Build Pte Ltd is not a real company.

Flow 05

Subcontractor claims and payment responses

Subcontractor claims arrive in every format, often in the last days of the month, and the payment response has a deadline. Assessed by hand, the claimed percentage tends to be accepted because there is no time to check it against site, or the response goes out late without the reasons for any cut.

Starts when
A subcontractor serves a payment claim by email, by hand or through the intake page.
Ends with
A subcontractor claim with its assessment by item, a payment response and certificate with reasons, proof of service, certified cost on the project, payable retention updated, and a certificate waiting for the tax invoice in finance.
  1. 1.Agent: Document intake agent

    Reads the claim and drafts a subcontractor claim record against the subcontract with the claimed amount, items and percentages.

    • Matched to an open subcontract by subcontractor and project; an unmatched claim goes to the project coordinator.
    • The date received is recorded separately from the date printed on the claim.
    • Bank details on the document are never read into the record; a bank detail change always goes to a person.
  2. 2.System: System

    Sets the payment response due date and adds the claim to the response list.

    • A claim served before the subcontract's claim date is treated as served on that date (Act, section 10(3)), so the clock starts there.
    • Response due = the earlier of the subcontract's date and 21 days after service, or 14 days after service if the subcontract sets none (Act, section 11(1)).
    • The list is sorted by days left.
  3. 3.System: System

    Compares each claimed item with the last confirmed site update for the contract items it maps to.

    • A claimed percentage more than the set tolerance (2 points in the sample) above the confirmed percentage is flagged.
    • Claims above 100% of an item, or for scope outside the subcontract and its approved variations, are flagged.
  4. 4.Person: Project manager

    Assesses each item, setting the percentage the company accepts and the reason for any cut.

    • Assessed value to date minus retention to date minus previously certified = response amount before GST.
    • Back charges are deducted only with a record of the work and the notice reference.
    • Every item assessed below the claim needs a reason.
  5. 5.System: System

    Drafts the payment response and the payment certificate from the assessment.

    • The response identifies the claim, states the response amount and, where it is less than claimed, the reason for the difference and for any amount withheld (Act, section 11(3)).
  6. 6.Person: Project manager

    Approves the payment response and certificate, or passes it to the director above the limit.

    • By value before GST: project manager up to S$50,000.00, director above (sample matrix).
    • Claims with 3 days or fewer left move to the top of each approver's list.
  7. 7.Person: Contracts administrator

    Sends the payment response to the subcontractor before the due date.

    • Messages to suppliers and subcontractors always stop at a person.
    • The date and method of sending are recorded as proof of service.
  8. 8.System: System

    Books the certified gross value as actual cost, adds retention to the payable retention ledger and passes the certificate to finance.

    • The bill is matched to the certificate when the subcontractor's tax invoice arrives.
    • Payment due = the earlier of the subcontract's date and 35 days after the tax invoice, or after the response due date if the subcontractor is not GST-registered (Act, section 8(1)); 14 days where the subcontract sets no date (section 8(2)).
    • Payments always stop at a person: finance approves the payment run.

Exceptions

The assessment will not be ready by the due date
The claim turns red 3 days before. The project manager can approve a response on what has been checked so far; the system never lets the date pass without a flag, because without a response the subcontractor may apply for adjudication after the 7-day dispute settlement period (Act, sections 12(2) and 12(6)).
The subcontractor disputes the response
The dispute is recorded with the end of the dispute settlement period. A varied response is a new version with the old one kept, and it can only be issued within the window the Act allows (section 11(4)).
A notice of intention to apply for adjudication arrives
The document intake agent files it against the claim and the contracts manager is alerted. The system gathers the claim, the response, the site updates and photos into one pack for the contracts manager and their adviser.
The claim includes extra work with no approved subcontract variation
Those lines are assessed at nil with that reason stated, and a draft subcontract variation is raised for the project manager to price.
The claimant supplies goods only, under a supply contract
The Act's rules for supply contracts apply instead (section 11(2) on responses, section 8(3) and (4) on due dates), so the due date follows the contract tag set at subcontract or PO award.
The defects liability period on a subcontract ends
Retention release is listed for the project manager, who certifies it after checking open defects for that subcontractor.

Worked example

Claim 4 from Kestrel M&E on P-24-021, Lakeside clinic

  • Subcontract S$140,000.00, retention 5%, response within 14 calendar days under the subcontract.
  • Claimed 78% to date: S$109,200.00, less retention S$5,460.00 = S$103,740.00, less certified S$71,250.00 = S$32,490.00.
  • Confirmed site update of 28 Oct shows 70%: assessed S$98,000.00.
  • S$98,000.00 less retention 5% S$4,900.00 = S$93,100.00, less certified in claims 1 to 3 S$71,250.00 = S$21,850.00.
  • Response amount S$21,850.00 before GST, S$23,816.50 with GST 9%. Difference from the claim: S$10,640.00.
  • Reason stated: ductwork on levels 3 and 4 not installed at the 28 Oct site walk.
  • Served 31 Oct. The subcontract's 14 calendar days run out before the Act's 21 days, which leave out public holidays, so the response is due 14 Nov. The project manager approves (under S$50,000.00).

Sample data. Ridgeway Build Pte Ltd is not a real company.

Flow 06

Cost to complete and margin forecast

The margin a project finishes on depends on the cost still to come, which a report of spend to date does not show. Without a monthly cost to complete per cost code, a project keeps reporting its margin at award until the last months, when the remaining costs arrive together and there is little left to recover.

Starts when
The progress claim for the month is approved, or the project director asks for a forecast.
Ends with
A signed monthly forecast per project with forecast final cost and margin by cost code, the movements since last month with reasons, and the watch list updated.
  1. 1.System: System

    Takes a snapshot of the revised contract sum, revised budget, actual cost and open commitments by cost code at the claim cut-off.

    • The same cut-off as the claim, so value earned and cost are compared for the same period.
    • Actual cost = approved bills + certified subcontract claims + labour costed from timesheets + store issues.
  2. 2.System: System

    Pre-fills the estimate to complete for each cost code from the budget not yet spent or committed.

    • Pre-fill = revised budget minus actual minus open commitments, never below zero.
    • A cost code already over budget pre-fills at zero and is flagged, so it cannot be signed off without an estimate.
  3. 3.Person: Project manager

    Replaces each pre-filled figure with an estimate of what it will cost to finish that cost code.

    • Any change from the pre-fill needs a basis: quantity left times rate, a quote in hand, or weeks of preliminaries left.
    • Labour and preliminaries are checked against the weeks left to the completion date.
  4. 4.System: System

    Calculates the forecast final cost, its variance to the revised budget and the forecast margin.

    • Forecast final cost = actual + open commitments + estimate to complete.
    • Forecast margin = revised contract sum (approved VOs only) minus forecast final cost.
    • Pending VOs: their cost is in, their value is shown beside the margin as possible recovery.
  5. 5.System: System

    Compares the forecast with last month's signed forecast and with the budget.

    • A margin drop of more than 2 percentage points in a month, or any cost code more than 5% over its revised budget, goes to the project director with the cost codes that caused it.
    • Cost to date running ahead of value earned to date (as a share of forecast cost and revised contract sum) is flagged.
  6. 6.Person: Project director

    Reviews the forecast and signs it off with notes on the actions agreed.

    • The signed forecast is frozen as that month's version; next month's comparison runs against it.
  7. 7.System: System

    Publishes the signed forecast to the company project report and to finance for month-end reporting.

    • Finance sees forecast cost and margin per project; the accounting treatment stays with your accountant.

Exceptions

A pending variation looks likely to be rejected
The project manager sets its expected recovery to nil with a note; its cost stays in the forecast either way.
A subcontractor is expected to claim beyond its subcontract value
The expected extra is entered as estimate to complete on the subcontract cost code, with the subcontract variation number if one exists.
The project is running late and liquidated damages may apply
The project manager enters a provision as its own forecast line, the contract's daily rate times the expected days of delay, and it reduces the forecast margin until an extension of time is granted or the provision is released.
Forecast margin falls below the company minimum
The project goes on the director's watch list and the forecast moves from monthly to weekly until it recovers.
Only the final account is left
The forecast switches to final account mode, where the open items are agreed VO values, retention to release and any disputed amounts.

Worked example

Forecast at claim 6 on P-24-017

  • Revised contract sum S$498,400.00 (approved VOs only). Revised budget S$423,400.00.
  • Materials: S$142,380.00 actual + S$6,420.00 committed + S$4,200.00 to complete = S$153,000.00, against S$141,200.00.
  • Labour: S$30,000.00 + S$0.00 + S$35,800.00 = S$65,800.00, against S$66,800.00.
  • Subcontract: S$92,000.00 + S$88,000.00 + S$2,000.00 = S$182,000.00, against S$182,400.00.
  • Preliminaries: S$18,000.00 + S$3,600.00 + S$13,400.00 = S$35,000.00, against S$33,000.00.
  • Forecast final cost S$435,800.00 (S$282,380.00 actual + S$98,020.00 committed + S$55,400.00 to complete), S$12,400.00 over the revised budget.
  • Forecast margin S$62,600.00, 12.6% of the revised contract sum, down from 15.0% at award. Materials (8.4% over) and preliminaries (6.1% over) pass the 5% rule, so the forecast goes to the project director.
  • VO-04 (S$6,250.00, pending): its cost is already in the forecast. If approved at that value, margin becomes S$68,850.00, 13.6% of S$504,650.00.

Sample data. Ridgeway Build Pte Ltd is not a real company.

Design decisions

Why the flows work this way

The choices behind the order of the steps and the checks, and what each one trades off.
  • Each claim restates work done to date and deducts the amount previously certified

    The claim is worked out from cumulative figures every month: value to date, retention to date, certified to date. If the client's QS cut claim 5, the shortfall comes back in claim 6 without anyone re-entering it, and a percentage keyed wrongly one month is corrected the next. Claiming only the month's increment is easier to read, but every past error carries forward and the claimed and certified totals drift apart.

  • Pending variations are listed with the claim and left out of the claimed amount

    A claim padded with unapproved work invites the client's QS to question the whole claim, and the progress claim agent is never allowed to claim an unapproved variation. The opposite risk is instructed work going unclaimed for months, so every claim carries a schedule of pending VOs with value and age, and the weekly register lists them oldest first. Contractors who want pending VOs on the payment claim as a separate line can switch that on, with only the QS able to add the line.

  • The contract sum and the budget move through separate approvals

    The client's approval of a VO changes the revised contract sum; the project manager posting its cost estimate changes the revised budget. Keeping them apart lets a VO be approved by the client before its cost is final, and an internal budget transfer never touches what the client is charged. The original sum and budget stay locked, so the cost report can show how much of an overrun came from variations and how much from base scope.

  • Commitments count against the budget when the PO or subcontract is approved

    A report that counts only bills shows an overrun after the order has been placed, when the money is already committed. Counting open PO and subcontract balances means the warning fires while someone can still change the order. The trade-off is that a large subcontract makes its cost code look nearly spent on the day it is let, which is why actual and committed sit in separate columns.

  • Subcontractor claims are assessed against our own site record, and their dates never depend on the client paying us

    The assessed percentage comes from the project manager's confirmed site update for the same contract items, so a subcontractor's 78% is checked against what was recorded on site. Section 9 of the Security of Payment Act makes pay-when-paid clauses unenforceable, so each subcontract keeps its own response and payment dates and nothing links them to the client's certificate. The cost is setup work: subcontract scopes have to be mapped to contract items in the first weeks of a project.

  • The forecast counts the cost of instructed work in full and only the value of approved variations

    Work instructed on site gets done whether or not the client signs, so its cost belongs in the forecast as soon as it is incurred or committed. Its value is shown beside the margin as possible recovery. This keeps the reported margin lower while VOs are pending, which project directors sometimes push back on, but it stops the margin falling late when a VO is rejected.

Scoping

Settings we agree with you before the build

Each of these changes how the flows behave. We settle them on the scoping call and write them into the phase plan.
Contract breakdown
OptionsLump sum with a schedule of values, measured BOQ, or schedule of rates
Usual startThe breakdown the client's QS certifies against, usually the priced tender BOQ, so claim lines match the certificate line for line.
Cost codes
OptionsA few broad codes (materials, labour, subcontract, preliminaries), or codes by trade and element
Usual startThe codes your estimators already price with, so tender and budget compare directly; broad codes if there is no estimating system yet.
Retention
OptionsFlat percentage, percentage up to a cap, release in one or two stages, or a retention bond instead of cash
Usual startEntered per contract from its clauses; the sample here is 5% with half released at completion and half at the end of the defects liability period.
Payment response and due dates
OptionsFrom each contract's payment clause, checked against the limits in the Security of Payment Act
Usual startEntered per contract with the clause number, and the system uses the earlier of the contract date and the Act's limit; your contracts adviser confirms the dates.
Budget warning thresholds
OptionsWarn only, warn at 90% and need approval above 100%, or block above 100%
Usual startWarn at 90% and need the project director above 100%, because a hard block stops site work over small overruns.
Pending variations on a claim
OptionsListed under the claim only, or claimed as a separate line added by the QS
Usual startListed only, which matches how the progress claim agent works and keeps the claimed amount to approved work.
Claim and certificate approvals
OptionsOne approver, or quantities and amounts approved by different people, with value limits
Usual startProject manager confirms quantities, QS approves claims up to S$100,000.00 before GST and the project director above, as in the sample matrix.
Site evidence rule
OptionsPhoto or note required above a percentage, a jump threshold per month, both, or none
Usual startA photo or note for any item that moves more than 15 points in a month, so the QS has something to show the client's QS.

Key records

The records it holds

Each record lives once in the shared database, so other modules and agents read the same version.
  • Project

    • Contract sum
    • Client
    • Cost codes
    • Budget
  • Contract item

    • Description
    • Value
    • Work done %
  • Variation order

    • Value
    • Status
    • Client sign-off
  • Progress claim

    • Work done
    • Variations
    • Retention
    • Previous claims
  • Site update

    • Photos
    • Quantities
    • Confirmed by
  • Subcontract

    • Scope
    • Value
    • Claims
    • Retention

Approvals

Who approves what, and above which amount

Agent drafts and staff drafts follow the same rules. The matrix is built to your roles and limits.
SampleApproval matrix for projects and progress claims
Site update counted toward a claimWhenAnyWho approvesProject manager
Variation order sent to the clientWhenAny amountWho approvesProject manager
Progress claim to the clientWhenUp to S$100,000Who approvesQuantity surveyor
Progress claim to the clientWhenAbove S$100,000Who approvesProject director
Subcontractor payment certificateWhenUp to S$50,000Who approvesProject manager
Subcontractor payment certificateWhenAbove S$50,000Who approvesDirector

A sample matrix for a fit-out contractor. Amounts are before GST. Yours follows your own roles and limits.

Sample data. Ridgeway Build Pte Ltd is not a real company.

Connects to

What it shares with the other modules

The records below are read and written by both modules, so nothing is typed twice.

Planning

Which phase it usually ships in

Usually in the first phase for contractors

For construction and engineering firms, claims and variations are often where the money is stuck, so this module usually leads, with purchasing for site requisitions. Claims can hand over to the accounting system you keep until finance joins.

Planning guidance from how we usually scope, not a rule. Your written phase plan sets the actual scope, price and go-live date before you sign.

Price bands

  • Quick build

    2 to 3 days of build

    From S$15k

    One workflow or one agent, on your data.

  • Build

    4 to 5 days of build

    S$30k to S$40k

    A set of modules and agents around one part of the business.

  • Enterprise programme

    Months, in phases

    Around S$150k

    A full ERP programme, delivered phase by phase.

No per-user licence fees. You own the full source code of what we build.

Industries

Industries that use it

Industry pages bundle this module with the others each trade usually starts with. See all industries.

FAQ

Projects and progress claims questions

How does the progress claim agent work out a claim?

+
It takes work done by contract item from the confirmed site updates, adds variations the client has approved, deducts retention and the amounts certified on earlier claims, and drafts the claim with every step shown. Your quantity surveyor approves it before it goes out.

What happens to variations the client has not signed off?

+
They stay out of the claim. Each variation order carries its status and the client's sign-off, and the agent includes only approved ones, noting any it left out.

Can it handle retention?

+
Yes. Retention rates and limits are set per contract, held on each claim, and released on the dates your contract sets.

Can it check and pay subcontractor claims?

+
It can check them. Subcontractor claims are compared with confirmed work done, and a payment certificate is drafted for the project manager. Payments always stop at a person.

Can it track claim and payment dates for each contract?

+
Yes. Claim dates, response due dates and payment due dates are records on each contract, and anything overdue shows in one list. Which dates apply comes from your contracts.

How do updates get in from site?

+
Site teams send in photos and notes. The document intake agent turns them into a draft site update against the right project and items, and the project manager confirms it.

Is this only for construction?

+
No. It suits any company that runs work as projects with budgets and staged billing, such as fit-out, M&E, engineering and installation firms.

Add this to your first phase

Bring the projects workflow that hurts most. In 30 minutes we show how it would run as an approval queue on sample data, and what a first phase would cost.