> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/readme/projects/review-progress-and-invoices.md).

# Review, progress payments, and invoices

Review each finished phase, send it back with a punch list if it needs one, and understand how a project bills: the deposit, progress payments, time and materials, change orders, retainage, and the fi

A project doesn't bill when a visit is completed, the way a job does. It bills in steps you agreed with the customer, and each step is released when something happens: the customer approves, a phase is reviewed, the project closes out. Reviewing a phase is the moment you check the crew's hours, materials, and photos, and let the next payment go.

## How a project bills

Every project has a **payment schedule**, set when the customer approves (see [Mark approved](https://docs.shortcutco.com/readme/projects/estimate-and-approval.md#4-approve-for-the-customer)). It splits the **fixed-price** part of the contract into percentages, each with a trigger:

| Payment       | When it's invoiced                                                                                                        | Typical share |
| ------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------- |
| **Deposit**   | **On approval** — the moment the customer signs or you mark the project approved. The invoice is emailed with a pay link. | 25 %          |
| **Progress**  | **When \[phase] is reviewed** — you release it from the review of that phase.                                             | 50 %          |
| **Balance**   | **At closeout** — drafted when you close out the project, as the final invoice.                                           | 25 %          |
| **Retainage** | **Days after closeout** — a slice the customer holds back; sent on its own on the due date.                               | optional      |

The percentages apply to the fixed-price work only, after any discount and before tax. Each invoice adds its share of the tax. Three things bill outside the schedule, on whichever invoice goes out next:

* **Time and materials** — a T\&M phase's punched hours × its rate, and the materials the crew used, at the price book price when they recorded them. The line reads *7 h × $65*.
* **Change orders** — a signed change order with **Bill with next invoice**, as one line. One with its own payment line was invoiced when the customer signed.
* **Credits** — a credit change order, as a negative line.

The project page keeps the running score: the **Billed · paid** stat (*$7,161.58 paid · Next: 40% at closeout*), *The customer owes $4,403.42 on issued invoices.*, and the **Payment schedule** on the right, where each payment reads **Proposed**, **Upcoming**, **Waiting on review**, **Due**, *#1003 · Sent · $6,427.06*, or *#1002 · Paid · $4,590.76*.

**Re-split unbilled payments…** under the schedule spreads what's left to bill differently across the payments that aren't on an invoice yet (type each amount, or **Split equally**, and **Save new split**). The signed estimate and the invoices already sent don't change.

{% hint style="info" %}
Project invoices are ordinary invoices once they exist. They're in [Invoices](https://shortcutco.com/invoices) and on the customer's profile, customers pay them the usual way, and reminders, partial payments, receipts, and QuickBooks all work as they do for jobs. See [Finances](https://docs.shortcutco.com/readme/finances-invoices-and-payments.md). In QuickBooks, project lines post to the **Project income**, **Project labor** and **Project materials** accounts you pick in Settings; see [Projects: income, labor and materials](https://docs.shortcutco.com/readme/configuration/quickbooks-integration.md#projects-income-labor-and-materials).
{% endhint %}

## Review a phase

When the lead declares a phase done (or a T\&M phase **Done**), the phase turns **Ready for review**, the project manager gets a push, and the project's main button reads **Review \[phase]**. Click it (or **Review** on the phase row). The review opens as a drawer on desktop and a page on a phone:

* **Hours** — measured against the budget, the **Days** worked, and the **Phase margin** against **Same as sold**. If the phase ran over, **Why over budget?** shows the lead's reason (**Site condition**, **Estimating miss**, **Team productivity**, **Weather**, **Other**); change it if you know better.
* **Hours by day** — each day with who was on it and their times. **Fix times** opens the time correction; **Exclude** keeps a day off this review and its invoice until it's fixed. A day with someone still clocked in, or a punch that synced late, shows **Needs office review**, and **Approve** waits until each one is fixed or excluded.
* **Materials used** — **Estimated**, **Used**, and the **Cost diff**.
* **Completion photos** and the lead's note.
* **Punch list** — on a phase that came back from a punch list, each item and whether it's **Done** or **Can't do**.
* **Payment** — the progress payment this phase triggers: **Create \[milestone] invoice · $5,247.17** is ticked by default (*A draft · nothing reaches the customer until it's sent*). Untick it to hold the money for now. Time-and-materials lines and next-invoice change orders ride along on the same invoice; the preview lists exactly what it will carry.
* **Note (optional)**.

Then **Approve phase**, or **Send back**.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-89e3878e58a5fc66bd5f8eae5ac97af3005233b9%2Fprojects-review-drawer.png?alt=media" alt="The review drawer for the Wall phase: Hours measured against budget with the days and phase margin, Why over budget, Hours by day with each worker&#x27;s times, Materials used, Completion photos, the Payment section with Create progress invoice ticked, and the Send back and Approve phase buttons"><figcaption><p>Reviewing a phase: the hours, the materials, the photos, and the invoice it releases.</p></figcaption></figure>

**Approve phase** marks it **Reviewed**: the hours and materials freeze for the closeout, and the invoice draft is created under **Documents** (*Invoice draft created · $5,616.47. Send it from Documents.*). Open the draft, check it, and send it like any invoice.

**Hours that change after review** (a late sync, a time correction) don't un-review the phase. The project shows *Hours changed after review on Wall (+1.2 h)* with **Re-review**; approving again freezes the new hours, and the difference on a T\&M phase bills on the next invoice.

### Send back with a punch list

If the walk-through turned up fixes, click **Send back**. List each item under **Punch list** (**What needs fixing**, with a before photo if you have one; at least one item), **Book a follow-up visit** (the next free slot on the same team is suggested; change the **Team**, **Planned hours**, and **Follow-up day**, or pick **No follow-up visit**), decide whether to **Hold \[progress] invoice until punch list is done** (on by default), and add a **Note to \[lead]**. Click **Send back · 2**.

The phase goes back to **In progress** with a **Punch list · 2** pill, the lead gets a push and the punch list on their phone (see [Punch lists](https://docs.shortcutco.com/readme/projects/crew-app-on-a-project.md#punch-lists)), and the follow-up day shows on Dispatch. You can add items later from the project (**Punch list** in the waiting box). When the lead marks the list done, the phase comes back for review.

### Declare for the team

The office can declare progress too: on the phase row, **⋯ → Declare progress for team**, pick the percentage, add a reason if it's over, and a note. It's logged as *Pat for Install B*, and the lead gets a push. At 100 % the phase moves to **Ready for review**.

## Time and materials

A T\&M phase has no fixed price: the customer pays for the hours the crew punches on it, at the rate on the phase, plus the materials they record on their checklist, at the price book price. The project page shows it as **T\&M · $65/h** with *\~8 h* and *\~$520* estimated. Its labor is taxed or not according to **Sales tax on labor** under the phases.

T\&M work bills on the next invoice that goes out, whatever its trigger: a progress invoice, a change order invoice, or the final. To bill it sooner, click **Bill T\&M to date** under the project stats: the preview lists the finalized hours up to today and the materials used, and **Create · $x** drafts the invoice. Hours from a shift that's still open wait for the next one. The lead ends a T\&M phase with **Mark done**, and it bills without a review unless you open one.

## Deposits

The deposit invoice goes out on approval, by email with a pay link (or the customer pays it on the spot while signing). Until it's paid, the project page says *Waiting on the customer to pay the deposit ($623.74).* with **Remind**, the Backlog shows the project under **Waiting on deposit**, and scheduling warns (or is blocked, with **Require deposit before scheduling** on). Small jobs can skip the deposit altogether; see [Settings](https://docs.shortcutco.com/readme/projects/settings-and-price-book.md).

## What the customer gets

Every project invoice is the same page customers know from jobs, with the project added. **On this invoice** names the payment (*Progress · Excavation & base · 35%*, *Estimate Rev 1 · payment 2 of 3*), any T\&M lines (*Time & materials, approved Sep 23 · 7 h × $65*) and change orders, then **Subtotal**, **Sales tax**, **Total**, what's **Paid**, and the **Amount due**. **Payments received** lists the deposit and any earlier invoices, and **Your contract** shows the signed estimate and each signed change order with the **Contract total, incl. tax**. The final invoice carries the warranty line and a thank-you. See [How customers pay an invoice](https://docs.shortcutco.com/readme/finances-invoices-and-payments/how-customers-pay-an-invoice.md).

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-2fc2951dcf2cba7dedbc48288002d5b589710523%2Fprojects-customer-invoice-phone.png?alt=media" alt="A progress invoice on the customer&#x27;s phone: Invoice · Backyard patio &#x26; seat wall, On this invoice with Progress · Excavation &#x26; base · 35% as payment 2 of 3, Subtotal, Sales tax, Total, Paid and Amount due, Payments received listing the deposit, and Your contract with the signed estimate and CO-1"><figcaption><p>A progress invoice: which payment it is, what's been paid so far, and the contract behind it.</p></figcaption></figure>

## Fixing an invoice

A project invoice that's wrong is corrected from the project's **Documents** or from [Invoices](https://shortcutco.com/invoices): **Void…** a sent invoice (its payment goes back to **Due** and whatever it billed is free for the next invoice), **Void draft…** a draft, or **Void and reissue…** one that was copied to QuickBooks. Give a **Reason**. A failed invoice (*Deposit didn't go out.* in the waiting box) has **Retry**. See [Refunds & credit memos](https://docs.shortcutco.com/readme/finances-invoices-and-payments/refunds-and-credit-memos.md).

<details>

<summary>Still stuck?</summary>

Email <hello@shortcutco.com> with the project name, the phase, and a screenshot of the review or the payment schedule.

</details>
